Bagikan melalui


CA1859: Gunakan jenis beton jika memungkinkan untuk meningkatkan performa

Properti Nilai
ID Aturan CA1859
Judul Gunakan jenis beton jika memungkinkan untuk meningkatkan performa
Golongan Performa
Perbaikan bersifat disruptif atau non-disruptif Non-disruptif
Versi yang diperkenalkan .NET 8
Diaktifkan secara default di .NET 8 Sebagai saran

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 jenis beton menyebabkan kualitas kode yang dihasilkan lebih tinggi dengan meminimalkan overhead pengiriman virtual atau antarmuka dan mengaktifkan 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 jenis seperti 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.