Kiedy należy używać GC.SuppressFinalize()?

SuppressFinalize powinien być wywoływany tylko przez klasę, która ma finalizer. Informuje Garbage Collector (GC), że obiekt został całkowicie wyczyszczony.

Zalecany wzór IDisposable Gdy masz finalizer to:

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);
    }
}

Zwykle CLR przechowuje Zakładki na obiektach z finalizerem podczas ich tworzenia (co powoduje, że ich tworzenie jest droższe). SuppressFinalize informuje GC, że obiekt został prawidłowo wyczyszczony i nie musi wchodzić do kolejki finalizera. Wygląda jak C++ Destruktor, ale nie zachowuje się jak jeden.

Optymalizacja SuppressFinalize nie jest trywialna, ponieważ twoje obiekty mogą długo czekać w kolejce finalizera. Nie daj się skusić, aby wywoływać SuppressFinalize na inne przedmioty. To poważna wada.

Wytyczne projektowe informują nas, że finalizer nie jest konieczny, jeśli twój obiekt implementuje IDisposable, ale jeśli masz finalizer, powinieneś zaimplementować IDisposable, aby umożliwić deterministyczne oczyszczanie twojej klasy.

Większość czas, w którym powinieneś być w stanie uciec z IDisposable, aby oczyścić zasoby. Finalizer powinien być potrzebny tylko wtedy, gdy obiekt przechowuje niezarządzane zasoby i musisz zagwarantować, że zasoby te zostaną wyczyszczone.

Uwaga: czasami Programiści dodają finalizer do debugowania kompilacji własnych klas IDisposable w celu sprawdzenia, czy kod prawidłowo usunął obiekt IDisposable.

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

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