﻿<?xml version="1.0" encoding="utf-8"?><Type Name="UseCorrectDisposeSignaturesRule" FullName="Gendarme.Rules.Design.UseCorrectDisposeSignaturesRule"><TypeSignature Language="C#" Value="public sealed class UseCorrectDisposeSignaturesRule : Gendarme.Framework.Rule, Gendarme.Framework.ITypeRule" /><TypeSignature Language="ILAsm" Value=".class public auto ansi sealed beforefieldinit UseCorrectDisposeSignaturesRule extends Gendarme.Framework.Rule implements class Gendarme.Framework.IRule, class Gendarme.Framework.ITypeRule" /><AssemblyInfo><AssemblyName>Gendarme.Rules.Design</AssemblyName><AssemblyVersion>4.2.0.0</AssemblyVersion></AssemblyInfo><Base><BaseTypeName>Gendarme.Framework.Rule</BaseTypeName></Base><Interfaces><Interface><InterfaceName>Gendarme.Framework.ITypeRule</InterfaceName></Interface></Interfaces><Attributes><Attribute><AttributeName>Gendarme.Framework.Problem("An IDisposable type does not conform to the guidelines for its Dispose methods.")</AttributeName></Attribute><Attribute><AttributeName>Gendarme.Framework.Solution("Fix the signature of the methods or add the Dispose (bool) overload.")</AttributeName></Attribute></Attributes><Docs><summary>
             There is a convention that should be followed when implementing <c>IDisposable</c>. Part
             of this convention is that Dispose methods should have specific signatures. In
             particular an <c>IDisposable</c> type's Dispose methods should either be nullary or unary
             with a bool argument, <c>Dispose ()</c> should not be virtual, <c>Dispose (bool)</c> should
             not be public, and unsealed types should have a <c>protected virtual Dispose (bool)</c> method.
             For more details see: [http://www.bluebytesoftware.com/blog/2005/04/08/DGUpdateDisposeFinalizationAndResourceManagement.aspx].
             </summary><remarks>This rule is available since Gendarme 2.6</remarks><example>
             Bad example:
             <code>
             public class Unsealed : IDisposable
             {
             	~Unsealed ()
             	{
             		Dispose (false);
             	}
             	
             	public void Dispose ()
             	{
             		Dispose (true);
             		GC.SuppressFinalize (this);
             	}
             	
             	// This is not virtual so resources in derived classes cannot be
             	// cleaned up in a timely fashion if Unsealed.Dispose () is called.
             	protected void Dispose (bool disposing)
             	{
             		if (!Disposed) {
             			// clean up my resources
             			Disposed = true;
             		}
             	}
             	
             	protected bool Disposed {
             		get;
             		set;
             	}
             }
             </code></example><example>
             Good example:
             <code>
             public class Unsealed : IDisposable
             {
             	// Unsealed classes should have a finalizer even if they do nothing 
             	// in the Dispose (false) case to ensure derived classes are cleaned 
             	// up properly.
             	~Unsealed ()
             	{
             		Dispose (false);
             	}
             	
             	public Unsealed ()
             	{
             	}
             	
             	public void Work ()
             	{
             		// In general all public methods should throw ObjectDisposedException
             		// if Dispose has been called.
             		if (Disposed) {
             			throw new ObjectDisposedException (GetType ().Name);
             		}
             	}
             	
             	public void Dispose ()
             	{
             		Dispose (true);
             		GC.SuppressFinalize (this);
             	}
             	
             	protected virtual void Dispose (bool disposing)
             	{
             		// Multiple Dispose calls should be OK.
             		if (!Disposed) {
             			if (disposing) {
             				// None of our fields have been finalized so it's safe to
             				// clean them up here. 
             			}
             		
             			// Our fields may have been finalized so we should only
             			// touch native fields (e.g. IntPtr or UIntPtr fields) here.
             			Disposed = true;
             		}
             	}
             	
             	protected bool Disposed {
             		get; 
             		private set;
             	}
             }
             </code></example></Docs><Members><Member MemberName=".ctor"><MemberSignature Language="C#" Value="public UseCorrectDisposeSignaturesRule ();" /><MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" /><MemberType>Constructor</MemberType><AssemblyInfo><AssemblyVersion>4.2.0.0</AssemblyVersion></AssemblyInfo><Parameters /><Docs><summary>To be added.</summary><remarks>To be added.</remarks></Docs></Member><Member MemberName="CheckType"><MemberSignature Language="C#" Value="public Gendarme.Framework.RuleResult CheckType (Mono.Cecil.TypeDefinition type);" /><MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance valuetype Gendarme.Framework.RuleResult CheckType(class Mono.Cecil.TypeDefinition type) cil managed" /><MemberType>Method</MemberType><AssemblyInfo><AssemblyVersion>4.2.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>Gendarme.Framework.RuleResult</ReturnType></ReturnValue><Parameters><Parameter Name="type" Type="Mono.Cecil.TypeDefinition" /></Parameters><Docs><param name="type">To be added.</param><summary>To be added.</summary><returns>To be added.</returns><remarks>To be added.</remarks></Docs></Member></Members></Type>