应释放可释放的字段

更新：2007 年 11 月

原因

实现 System.IDisposable 的类型声明同样实现 IDisposable 的类型的字段。字段的 Dispose 方法不是由声明类型的 Dispose 方法调用。

规则说明

类型负责释放其全部非托管资源，这是通过实现 IDisposable 完成的。该规则进行检查，以确定可释放类型 T 是否声明字段 F，该字段为可释放类型 FT 的实例。对于每个字段 F，该规则尝试定位对 FT.Dispose 的调用。该规则搜索 T.Dispose 调用的方法及下一级方法（由 FT.Dispose 调用的方法所调用的方法）。

如何修复冲突

要修复与该规则的冲突，如果您负责分配和释放字段中包含的非托管资源，请在实现 IDisposable 的类型的字段上调用 Dispose。

何时禁止显示警告

如果您不负责释放字段包含的资源，或者对 Dispose 的调用发生在该规则所检查的调用级别以下的级别中，则可以安全地禁止显示此规则发出的警告。

示例

下面的示例演示实现 IDisposable（上文中讨论的 FT）的类型 TypeA。

using System;  

namespace UsageLibrary
{
    public class  TypeA :IDisposable
    {

        protected virtual void Dispose(bool disposing) 
        {
            if (disposing) 
            {
                // Dispose managed resources
            }

            // Free native resources
        }

        public void Dispose()
        {

                Dispose(true);

                GC.SuppressFinalize(this);

        }

        // Disposable types implement a finalizer.
        ~TypeA()
        {
            Dispose(false);
        }
    }
}

下面的示例演示与该规则冲突的类型 TypeB，方法是将字段 aFieldOfADisposableType（上文中讨论的 F）声明为可释放类型 (TypeA) 且不对字段调用 Dispose。TypeB 对应于上文所讨论的 T。

using System;  

namespace UsageLibrary
{
   public class  TypeB : IDisposable
   {
      // Assume this type has some unmanaged resources.
      TypeA aFieldOfADisposableType = new TypeA();
      private bool disposed = false;

      protected virtual void Dispose(bool disposing) 
      {
         if (!disposed) 
         {
            // Dispose of resources held by this instance.

            // Violates rule: DisposableFieldsShouldBeDisposed.
            // Should call aFieldOfADisposableType.Dispose();

            disposed = true;
             // Suppress finalization of this disposed instance.
             if (disposing)
             {
                 GC.SuppressFinalize(this);
             }
         }
      }

      public void Dispose()
      {
         if (!disposed)
         {
            // Dispose of resources held by this instance.
            Dispose(true);
         }
      }

      // Disposable types implement a finalizer.
      ~TypeB()
      {
         Dispose(false);
      }
   }
}

请参见

参考

实现 Finalize 和 Dispose 以清理非托管资源

System.IDisposable