CA1871: 'ArgumentNullException.ThrowIfNull' öğesine null atanabilir bir yapı geçirmeyin

Makale
04/06/2024

Özellik	Değer
Kural Kimliği	CA1871
Başlık	'ArgumentNullException.ThrowIfNull' öğesine null atanabilir bir yapı geçirmeyin
Kategori	Performans
Hataya neden olan veya bozulmayan düzeltme	Hataya neden olmayan
.NET 9'da varsayılan olarak etkin	Bilgi olarak

Neden

Örneğin, int? veya Guid?null atanabilir bir yapı öğesine ArgumentNullException.ThrowIfNullgeçirildiğinde, nesneye kutulanır ve performans cezasına neden olur.

Kural açıklaması

İyileştirilmiş performans için özelliğini denetlemek HasValue ve el ile özel durum oluşturmak, null atanabilir bir yapıyı 'a ArgumentNullException.ThrowIfNullgeçirmekten daha iyidir.

İhlalleri düzeltme

Null değerini denetleyin ve el ile atın ArgumentNullException .

Ö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, yapılandırma dosyasındaki önem derecesini noneolarak ayarlayın.

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

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

Aracılığıyla paylaş