CA1510: ArgumentNullException throw yardımcısı kullanma

  • Makale
Özellik Değer
Kural Kimliği CA1510
Başlık ArgumentNullException throw yardımcısı kullanma
Kategori Bakýmýný
Hataya neden olan veya bozulmayan düzeltme HataYa Neden Olmayan
.NET 8'de varsayılan olarak etkin Öneri olarak

Neden

Kod, bağımsız değişkenin olup null olmadığını denetler ve koşullu olarak bir ArgumentNullExceptionoluşturur.

Kural açıklaması

Bağımsız değişken denetimleri, kod boyutu üzerinde önemli bir etkiye sahiptir ve genellikle küçük işlevler ve özellik ayarlayıcıları için koda hakimdir. Bu denetimler, inlining'i engeller ve önemli miktarda yönerge önbelleği kirliliğine neden olur. gibi ArgumentNullException.ThrowIfNull throw-helper yöntemleri, yeni bir özel durum örneği oluşturan bloklardan daha if basit ve daha verimlidir.

Örnek

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

void M(string arg)
{
    if (arg is null)
        throw new ArgumentNullException(nameof(arg));
}

Aşağıdaki kod parçacığı düzeltmeyi gösterir:

void M(string arg)
{
    ArgumentNullException.ThrowIfNull(arg);
}

İhlalleri düzeltme

if Özel durum oluşturan bloğunu çağrısıyla ArgumentNullException.ThrowIfNulldeğiştirin. İsterseniz Visual Studio'da kodunuzu otomatik olarak düzeltmek için ampul menüsünü de kullanabilirsiniz.

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

Kodunuzun sürdürülebilirliği konusunda endişeleriniz yoksa bu kuralın ihlalini gizlemeniz güvenlidir. Hatalı pozitif olduğu belirlenen ihlallerin gizlenilmesi de uygundur.

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

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.CA1510.severity = none

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