CA2215: Atma yöntemleri taban sınıf atmayı çağırmalıdır
Ö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 9'da 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 base
DisposeDispose.
Uyarıların ne zaman bastırılması gerekiyor?
çağrısı, kuralın denetlediğinden daha derin bir çağrı base
Dispose 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 none
olarak 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 IDisposable ve TypeB
yöntemini doğru şekilde çağıran ve uygulayan TypeA
iki 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);
}
}
}
}