CA1510: Az ArgumentNullException dobássegítő használata

Tulajdonság	Érték
Szabályazonosító	CA1510
Cím	Az ArgumentNullException dobássegítő használata
Kategória	Fenntarthatóság
A javítás kompatibilitástörő vagy nem törik	Nem törés
Alapértelmezés szerint engedélyezve a .NET 8-ban	Javaslatként

Ok

A kód ellenőrzi, hogy egy argumentum szerepel-e, null majd feltételesen ArgumentNullExceptionegy .

Szabály leírása

Az argumentum-ellenőrzések jelentős hatással vannak a kód méretére, és gyakran uralják a kis függvények és a tulajdonsághalmazok kódját. Ezek az ellenőrzések megakadályozzák a címkézést, és jelentős utasítás-gyorsítótár-szennyezést okoznak. A dobássegítő módszerek, például ArgumentNullException.ThrowIfNull egyszerűbbek és hatékonyabbak, mint if az új kivételpéldányt építő blokkok.

Példa

A következő kódrészlet a CA1510 megsértését mutatja be:

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

A következő kódrészlet a javítást mutatja:

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

Szabálysértések kijavítása

Cserélje le a if kivételt okozó blokkot egy hívásra ArgumentNullException.ThrowIfNull. Vagy a Visual Studióban a villanykörte menü használatával automatikusan kijavíthatja a kódot.

Mikor kell letiltani a figyelmeztetéseket?

Ha nem aggódik a kód karbantarthatósága miatt, nyugodtan letilthatja a szabály megsértését. Az is jó, ha elnyomja a hamis pozitívnak minősített szabálysértéseket.

Figyelmeztetés mellőzése

Ha csak egyetlen szabálysértést szeretne letiltani, adjon hozzá előfeldolgozási irányelveket a forrásfájlhoz a szabály letiltásához és újbóli engedélyezéséhez.

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

Ha le szeretné tiltani egy fájl, mappa vagy projekt szabályát, állítsa annak súlyosságát none a konfigurációs fájlban.

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

További információ: Kódelemzési figyelmeztetések letiltása.