﻿<?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>3.10.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>3.10.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>3.10.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>