CA1859: Gunakan jenis beton jika memungkinkan untuk meningkatkan performa

Properti Nilai
ID Aturan CA1859
Judul Gunakan jenis beton jika memungkinkan untuk meningkatkan performa
Kategori Performa
Perbaikan bersifat merusak atau tidak merusak Tidak terputus
Versi yang diperkenalkan .NET 8
Diaktifkan secara default di .NET 10 Sebagai saran
Bahasa yang berlaku C# dan Visual Basic

Penyebab

Kode menggunakan jenis antarmuka atau jenis abstrak, yang mengarah ke panggilan antarmuka atau panggilan virtual yang tidak perlu.

Deskripsi aturan

Aturan ini merekomendasikan peningkatan jenis variabel lokal, bidang, properti, parameter metode, dan jenis pengembalian metode tertentu dari jenis antarmuka atau abstrak ke jenis konkret jika memungkinkan. Menggunakan tipe konkret meningkatkan kualitas kode yang dihasilkan dengan meminimalkan overhead pemanggilan virtual atau antarmuka dan memungkinkan inlining.

Aturan ini hanya melaporkan pelanggaran ketika ada panggilan virtual atau panggilan antarmuka yang benar-benar dapat dihindari dengan menggunakan jenis konkret.

Cara memperbaiki pelanggaran

Tingkatkan tipe sesuai yang direkomendasikan oleh aturan. Secara umum, mengubah jenis tidak berpengaruh pada perilaku kode, tetapi meningkatkan performanya.

Contoh

Cuplikan kode berikut menunjukkan pelanggaran CA1859:

abstract class A
{
    public virtual void M() { }
}

sealed class B : A
{ }

internal class C
{
    private readonly A _a = new B();

    public void Trigger()
    {
        // This performs a virtual call because
        // _a is defined as an abstract class.
        _a.M();
    }
}

Cuplikan kode berikut memperbaiki pelanggaran:

abstract class A
{
    public virtual void M() { }
}

sealed class B : A
{ }

internal class C
{
    private readonly B _b = new B();

    public void Trigger()
    {
        _b.M();
    }
}

Kapan harus menekan peringatan

Aman untuk menekan peringatan jika performa tidak menjadi perhatian.

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 CA1859
// The code that's violating the rule is on this line.
#pragma warning restore CA1859

Untuk menonaktifkan aturan untuk file, folder, atau proyek, atur tingkat keparahannya ke none dalam file konfigurasi.

[*.{cs,vb}]
dotnet_diagnostic.CA1859.severity = none

Untuk informasi selengkapnya, lihat Cara menyembunyikan peringatan analisis kode.