CA2215: Metode Dispose harus memanggil metode Dispose kelas dasar

Properti Nilai
ID Aturan CA2215
Judul Metode Dispose harus memanggil Dispose pada kelas dasar
Kategori Penggunaan
Perbaikan bersifat merusak atau tidak merusak Tidak terputus
Diaktifkan secara default di .NET 10 Tidak
Bahasa yang berlaku C# dan Visual Basic

Penyebab

Jenis yang mengimplementasikan System.IDisposable mewarisi dari jenis yang juga mengimplementasikan IDisposable. Metode pada tipe pewaris Dispose tidak memanggil metode pada tipe induk Dispose.

Deskripsi aturan

Jika suatu tipe mewarisi dari tipe disposable, tipe tersebut harus memanggil metode dari jenis dasarnya Dispose dari dalam metodenya sendiri Dispose. Memanggil metode tipe dasar Dispose memastikan bahwa sumber daya apa pun yang dibuat oleh tipe 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 pemanggilan ke base.Dispose terjadi pada tingkatan pemanggilan yang lebih dalam daripada yang diperiksa oleh aturan tersebut.

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

Lihat juga

  • Last updated on