CA1871: 'ArgumentNullException.ThrowIfNull' metoduna null olabilen bir yapı geçirmeyin

Mülk	Değer
Kural Kimliği	CA1871
Başlık	'ArgumentNullException.ThrowIfNull' öğesine null atanabilir bir yapı geçirmeyin
Kategori	Performans
Düzeltme, hata yapan veya hataya neden olmayan	Hataya neden olmayan
.NET 10'da varsayılan olarak etkin	Bilgi olarak

Neden

Null atanabilir bir yapı, örneğin int? veya Guid?, ArgumentNullException.ThrowIfNull'ye geçirildiğinde bir nesneye kutulanır ve bu, performans cezasına yol açar.

Kural açıklaması

Geliştirilmiş performans için, HasValue özelliğini kontrol etmek ve manuel olarak özel durum fırlatmak, ArgumentNullException.ThrowIfNull'e null atanabilir bir yapı geçmekten daha iyidir.

İhlalleri düzeltme

Null değerini denetleyin ve ArgumentNullException hatasını manuel olarak tetikleyin.

Örnek

Aşağıdaki kod parçacığı CA1871 ihlalini gösterir:

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

Aşağıdaki kod parçacığı ihlali düzeltir:

static void Print(int? value)
{
    if (!value.HasValue)
    {
        throw new ArgumentNullException(nameof(value));
    }

    Console.WriteLine(value.Value);
}

Uyarıların ne zaman bastırılması gerekiyor?

Performansla ilgili bir sorun yoksa bu uyarıyı bastırmak güvenlidir.

Uyarıyı gizleme

Yalnızca tek bir ihlali engellemek istiyorsanız, kuralı devre dışı bırakmak ve sonra yeniden etkinleştirmek için kaynak dosyanıza ön işlemci yönergeleri ekleyin.

#pragma warning disable CA1871
// The code that's violating the rule is on this line.
#pragma warning restore CA1871

Bir dosya, klasör veya projenin kuralını devre dışı bırakmak için önem derecesini noneyapılandırma dosyasında olarak ayarlayın.

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

Daha fazla bilgi için bkz. Kod analizi uyarılarını gizleme.