CA1825: Hindari alokasi larik panjang nol

Properti	Nilai
ID Aturan	CA1825
Judul	Hindari melakukan alokasi array berdimensi nol
Kategori	Performa
Perbaikan bersifat merusak atau tidak merusak	Tidak terputus
Diaktifkan secara default di .NET 10	Sebagai saran
Bahasa yang berlaku	C# dan Visual Basic

Penyebab

Sebuah Array kosong tanpa elemen akan dialokasikan.

Deskripsi aturan

Menginisialisasi array dengan panjang nol menyebabkan alokasi memori yang tidak perlu. Sebagai gantinya, gunakan instans array kosong yang dialokasikan secara statik dengan memanggil metode Array.Empty. Alokasi memori dibagikan di semua pemanggilan metode ini.

Cara memperbaiki pelanggaran

Untuk memperbaiki pelanggaran, ganti alokasi array dengan panjang nol dengan panggilan ke Array.Empty. Misalnya, dua cuplikan kode berikut menunjukkan pelanggaran aturan dan cara memperbaikinya:

class C
{
    public void M1()
    {
        // Violates rule CA1825.
        var a = new int[0];
    }
}

class C
{
    public void M1()
    {
        // Resolves rule CA1825 violation.
        var a = System.Array.Empty<int>();
    }
}

Tips

Perbaikan kode tersedia untuk aturan ini di Visual Studio. Untuk menggunakannya, posisikan kursor pada alokasi array, kemudian tekan Ctrl+. (titik). Pilih Gunakan Array.Empty dari daftar opsi yang ditampilkan.

Kapan harus menekan peringatan

Aman untuk menyembunyikan pelanggaran aturan ini jika Anda tidak khawatir mengenai alokasi memori tambahan.

Catatan

Anda mungkin melihat peringatan positif palsu dari aturan ini jika semua hal berikut ini berlaku:

• Anda menggunakan Visual Studio 2022 versi 17.5 atau yang lebih baru dengan versi .NET SDK yang lebih lama, yaitu, .NET 6 atau yang lebih lama.
• Anda menggunakan penganalisis dari .NET 6 SDK atau versi paket penganalisis yang lebih lama, seperti Microsoft.CodeAnalysis.FxCopAnalyzers.
• Anda menggunakan array panjang nol sebagai argumen atribut, umumnya sebagai parameter params.

Positif palsu disebabkan oleh perubahan besar dalam kompiler C#. Pertimbangkan untuk menggunakan penganalisis yang lebih baru yang berisi perbaikan untuk peringatan positif palsu. Tingkatkan ke Microsoft.CodeAnalysis.NetAnalyzers versi 7.0.0-preview1.22464.1 atau yang lebih baru atau gunakan penganalisis dari .NET 7 SDK.

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

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

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

Untuk informasi selengkapnya, lihat Cara menyembunyikan peringatan analisis kode.

Aturan terkait

• CA1814: Lebih baik gunakan array berjajar daripada multidimensi

Lihat juga

• Aturan kinerja