如何正确使用 GC.SuppressFinalize()?

如何正确使用 GC.SuppressFinalize()

这个帖子翻译自Stack Overflow 原贴请看https://stackoverflow.com/questions/151051/when-should-i-use-gc-suppressfinalize

SuppressFinalize 应该只被有终结器（finalizer）的class调用。它通知GC该对象已经完全释放。

有终结器的class的推荐IDisposal模式是：

public class MyClass : IDisposable
{
    private bool disposed = false;

    protected virtual void Dispose(bool disposing)
    {
        if (!disposed)
        {
            if (disposing)
            {
                // called via myClass.Dispose(). 
                // OK to use any private object references
            }
            // Release unmanaged resources.
            // Set large fields to null.                
            disposed = true;
        }
    }

    public void Dispose() // Implement IDisposable
    {
        Dispose(true);
        GC.SuppressFinalize(this);
    }

    ~MyClass() // the finalizer
    {
        Dispose(false);
    }
}

通常，在对象创建的时候CLR会对带有终结器的对象进行标记（这使创建成本变高）。SuppressFinalizer告诉GC该对象已经正确释放所以就不需再进入终结器队列。终结器看起来像一个C ++析构函数，但不会像C++那样行事。

SuppressFinalize优化并不简单，因为您的对象可以在终结器队列上等待很长时间。不要试图在其他物体上调用SuppressFinalize。那会是一个待发生的严重缺陷。

设计指南告诉我们，如果您的对象实现了IDisposable，则不需要终结器，但如果您有终结器，则应实现IDisposable以允许确定性地清理您的类。

大多数情况下，您应该能够使用IDisposable来清理资源。当对象使用非托管资源并且需要保证清理这些资源时，您应该只需要一个终结器。

注意：有时开发人员会添加一个终结器来调试自己的IDisposable类的构建，以便测试代码是否正确处理了它们的IDisposable对象。

    public void Dispose() // Implement IDisposable
    {
        Dispose(true);
    #if DEBUG
        GC.SuppressFinalize(this);
    #endif
    }

    #if DEBUG
    ~MyClass() // the finalizer
    {
        Dispose(false);
    }
    #endif