CA2215: Metode Buang harus memanggil pembuangan kelas dasar

Artikel
09/06/2023

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 8	Tidak

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

Bagikan melalui