CA2215: Atma yöntemleri taban sınıf atmayı çağırmalıdır

Makale
09/06/2023

Özellik	Değer
Kural Kimliği	CA2215
Başlık	Atma metotları taban sınıf atmayı çağırmalıdır
Kategori	Kullanım
Hataya neden olan veya bozulmayan düzeltme	Hataya neden olmayan
.NET 8'de varsayılan olarak etkin	Hayır

Neden

uygulayan System.IDisposable bir tür, aynı zamanda uygulayan bir türden devralır IDisposable. Dispose Devralan türün yöntemi, üst türün yöntemini çağırmazDispose.

Kural açıklaması

Bir tür atılabilir bir türden devralıyorsa, kendi Dispose yöntemi içinden temel türün yöntemini çağırması Dispose gerekir. Temel tür yöntemini çağırmak, temel tür Dispose tarafından oluşturulan tüm kaynakların serbest bırakılmasını sağlar.

İhlalleri düzeltme

Bu kuralın ihlalini düzeltmek için yönteminizde öğesini çağırın baseDispose Dispose.

Uyarıların ne zaman bastırılması gerekiyor?

çağrısı, kuralın denetlediğinden daha derin bir çağrı baseDispose düzeyinde gerçekleşirse, bu kuraldan gelen bir uyarıyı bastırmak güvenlidir.

Uyarıyı gizleme

Yalnızca tek bir ihlali engellemek istiyorsanız, kuralı devre dışı bırakmak ve sonra yeniden etkinleştirmek için kaynak dosyanıza ön işlemci yönergeleri ekleyin.

#pragma warning disable CA2215
// The code that's violating the rule is on this line.
#pragma warning restore CA2215

Bir dosya, klasör veya projenin kuralını devre dışı bırakmak için, yapılandırma dosyasındaki önem derecesini noneolarak ayarlayın.

[*.{cs,vb}]
dotnet_diagnostic.CA2215.severity = none

Daha fazla bilgi için bkz . Kod analizi uyarılarını gizleme.

Örnek

Aşağıdaki örnekte, TypeA türünden devralan TypeA ve TypeB yöntemini doğru şekilde çağıran ve uygulayan IDisposableiki tür gösterilmektedirDispose.

Namespace ca2215

    Public Class TypeA
        Implements IDisposable

        Protected Overridable Overloads Sub Dispose(disposing As Boolean)
            If disposing Then
                ' dispose managed resources
            End If
            
            ' free native resources
        End Sub

        Public Overloads Sub Dispose() Implements IDisposable.Dispose
            Dispose(True)
            GC.SuppressFinalize(Me)
        End Sub

        ' Disposable types implement a finalizer.
        Protected Overrides Sub Finalize()
            Dispose(False)
            MyBase.Finalize()
        End Sub

    End Class

    Public Class TypeB
        Inherits TypeA

        Protected Overrides Sub Dispose(disposing As Boolean)
            If Not disposing Then
                MyBase.Dispose(False)
            End If
        End Sub

    End Class

End Namespace

using System;

namespace ca2215
{
    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);
        }
    }

    public class TypeB : TypeA
    {
        protected override void Dispose(bool disposing)
        {
            if (!disposing)
            {
                base.Dispose(false);
            }
        }
    }
}