CA2215: Metode Buang harus memanggil pembuangan kelas dasar
Properti | Nilai |
---|---|
ID Aturan | CA2215 |
Judul | Metode buang harus memanggil pembuangan kelas dasar |
Golongan | Penggunaan |
Perbaikan bersifat disruptif atau non-disruptif | Non-disruptif |
Diaktifkan secara default di .NET 9 | No |
Penyebab
Jenis yang mengimplementasikan System.IDisposable warisan dari jenis yang juga mengimplementasikan IDisposable. Metode Dispose jenis pewarisan tidak memanggil Dispose metode jenis induk.
Deskripsi aturan
Jika jenis mewarisi dari jenis sekali pakai, jenis tersebut harus memanggil Dispose metode jenis dasar dari dalam metodenya sendiri Dispose . Memanggil metode jenis Dispose
dasar memastikan bahwa sumber daya apa pun yang dibuat oleh jenis dasar dirilis.
Cara memperbaiki pelanggaran
Untuk memperbaiki pelanggaran aturan ini, panggil base
.Dispose dalam metode Anda Dispose .
Kapan harus menekan peringatan
Aman untuk menekan peringatan dari aturan ini jika panggilan ke base
.Dispose terjadi pada tingkat panggilan yang lebih dalam daripada pemeriksaan aturan.
Menyembunyikan peringatan
Jika Anda hanya ingin menyembunyikan satu pelanggaran, tambahkan arahan praprosedur ke file sumber Anda untuk dinonaktifkan lalu aktifkan kembali aturannya.
#pragma warning disable CA2215
// The code that's violating the rule is on this line.
#pragma warning restore CA2215
Untuk menonaktifkan aturan untuk file, folder, atau proyek, atur tingkat keparahannya ke none
dalam file konfigurasi.
[*.{cs,vb}]
dotnet_diagnostic.CA2215.severity = none
Untuk informasi selengkapnya, lihat Cara menyembunyikan peringatan analisis kode.
Contoh
Contoh berikut menunjukkan dua jenis, TypeA
yang mengimplementasikan IDisposable, dan TypeB
yang mewarisi dari jenis TypeA
dan memanggil metodenya Dispose dengan benar.
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);
}
}
}
}