CA1510: Použijte pomocnou rutinu pro vyvolání výjimky ArgumentNullException

Vlastnost	Hodnota
ID pravidla	CA1510
Název	Použijte pomocnou metodu pro vyvolání ArgumentNullException
Kategorie	Udržovatelnost
Oprava, která může být destruktivní nebo nedestruktivní	Nepřerušované
Povoleno ve výchozím nastavení v .NET 10	Jako návrh
Příslušné jazyky	C# a Visual Basic

Příčina

Kód zkontroluje, zda je argument null a poté podmíněně vyvolá výjimku 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é zneužití instrukční cache. Pomocné metody, jako ArgumentNullException.ThrowIfNull, jsou jednodušší a efektivnější než bloky if, 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. Ve Visual Studio použijte nabídku se žárovkou k automatické opravě kódu.

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.