CA2215: İmha yöntemleri taban sınıfı imhayı çağırmalıdır.

Özellik Değer
Kural Kimliği CA2215
Başlık Dispose metotları temel sınıf dispose'u çağırmalıdır
Kategori Kullanım
Düzeltme bozucu ya da bozmayan olabilir Kesintisiz
.NET 10'da varsayılan olarak etkin Hayır
Geçerli diller C# ve Visual Basic

Neden

System.IDisposable uygulayan bir tür, IDisposable uygulayan bir türden devralır. 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 Dispose temel türün yöntemini çağırması 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 ihlalini düzeltmek için baseDispose. Dispose yönteminizde çağırın.

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

base Dispose çağrısı, kuralın denetlediğinden daha derin bir çağrı 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, IDisposable arabirimini uygulayan TypeA ve TypeA türünden devralan ve Dispose yöntemini doğru şekilde çağıran TypeB olmak üzere iki tür gösterilmektedir.

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

Ayrıca bkz.

  • Last updated on