CA2264: Jangan berikan nilai yang tidak dapat diubah ke 'ArgumentNullException.ThrowIfNull'

Properti	Nilai
ID Aturan	CA2264
Judul	Jangan meneruskan nilai yang tidak dapat diubah ke null ArgumentNullException.ThrowIfNull
Golongan	Penggunaan
Perbaikan bersifat disruptif atau non-disruptif	Non-disruptif
Diaktifkan secara default di .NET 10	Sebagai peringatan

Penyebab

Nilai yang dikenal tidak pernah null diteruskan ke ArgumentNullException.ThrowIfNull().

Deskripsi aturan

ArgumentNullException.ThrowIfNull melempar ketika argumen yang diteruskan adalah null. Konstruksi tertentu seperti struct yang tidak dapat diubah ke null (kecuali untuk Nullable<T>), parameter jenis yang dikenal sebagai struct yang tidak dapat diubah ke null, ekspresi 'nameof()', dan ekspresi 'baru' dikenal tidak pernah null, sehingga ArgumentNullException.ThrowIfNull tidak akan pernah melemparkan. Dengan demikian, panggilan ArgumentNullException.ThrowIfNull tidak perlu.

Dalam kasus struct, karena ArgumentNullException.ThrowIfNull menerima object?, struktur dikotak, yang menyebabkan penalti performa tambahan.

Cara memperbaiki pelanggaran

ArgumentNullException.ThrowIfNull Hapus panggilan.

Contoh

Cuplikan kode berikut menunjukkan pelanggaran CA2264:

static void Print(int value)
{
    ArgumentNullException.ThrowIfNull(value);
    Console.WriteLine(value);
}

Cuplikan kode berikut memperbaiki pelanggaran:

static void Print(int value)
{
    Console.WriteLine(value.Value);
}

Kapan harus menekan peringatan

Selalu aman untuk menekan peringatan ini.

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

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

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

Untuk informasi selengkapnya, lihat Cara menyembunyikan peringatan analisis kode.

Lihat juga

• CA1871: Jangan meneruskan struct nullable ke 'ArgumentNullException.ThrowIfNull