CA1510: Použití pomocné rutiny ArgumentNullException

  • Článek
Vlastnost Hodnota
ID pravidla CA1510
Název Použití pomocné rutiny vyvolání argumentuNullException
Kategorie Udržovatelnost
Oprava způsobující chybu nebo chybu způsobující chybu Nepřerušované
Povoleno ve výchozím nastavení v .NET 8 Jako návrh

Příčina

Kód zkontroluje, zda je null argument a podmíněně vyvolá znak .ArgumentNullException

Popis pravidla

Kontroly argumentů mají významný dopad na velikost kódu a často dominují kódu pro malé funkce a setter vlastností. Tyto kontroly brání inliningu a způsobují značné znečištění mezipaměti instrukcemi. Pomocné metody, jako ArgumentNullException.ThrowIfNull jsou jednodušší a efektivnější než if bloky, které vytváří novou instanci výjimky.

Příklad

Následující fragment kódu ukazuje porušení ca1510:

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

Následující fragment kódu ukazuje opravu:

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

Jak opravit porušení

if Nahraďte blok, který vyvolá výjimku voláním ArgumentNullException.ThrowIfNull. Nebo v sadě Visual Studio pomocí nabídky žárovky opravte kód automaticky.

Kdy potlačit upozornění

Pokud vás nezajímá udržovatelnost kódu, je bezpečné potlačit porušení tohoto pravidla. Je také v pořádku potlačit porušení, která jsou identifikována jako falešně pozitivní.

Potlačení upozornění

Pokud chcete pouze potlačit jedno porušení, přidejte do zdrojového souboru direktivy preprocesoru, abyste pravidlo zakázali a znovu povolili.

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

Pokud chcete pravidlo pro soubor, složku nebo projekt zakázat, nastavte jeho závažnost v none konfiguračním souboru.

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

Další informace naleznete v tématu Jak potlačit upozornění analýzy kódu.