CA2264: Übergeben Sie keinen nicht nullfähigen Wert an 'ArgumentNullException.ThrowIfNull'

Artikel
04/06/2024

Eigenschaft	Wert
Regel-ID	CA2264
Titel	Übergeben Sie keinen nicht nullablen Wert an 'ArgumentNullException.ThrowIfNull'
Kategorie	Verwendung
Fix führt oder führt nicht zur Unterbrechung	Nicht unterbrechend
Standardmäßig in .NET 9 aktiviert	Als Warnung

Ursache

Wenn ein Wert, der nie null sein kann, an null übergeben wird, wird nie eine Ausnahme ausgelöst ArgumentNullException.ThrowIfNull(), wodurch die Anweisung als No-Op festgelegt wird.

Regelbeschreibung

ArgumentNullException.ThrowIfNull wird ausgelöst, wenn das übergebene Argument nullist . Bestimmte Konstrukte wie nicht nullfähige Strukturen (mit Ausnahme Nullable<T>von ), 'nameof()'-Ausdrücken und 'neuen' Ausdrücken sind bekannt, dass sie niemals null sind, sodass ArgumentNullException.ThrowIfNull sie nie ausgelöst werden.

Im Falle einer Struktur, da ArgumentNullException.ThrowIfNull eine object?Struktur akzeptiert wird, wird die Struktur geschachtelt, was zu einer zusätzlichen Leistungsstrafe führt.

Behandeln von Verstößen

Entfernen Sie den ArgumentNullException.ThrowIfNull Anruf.

Beispiel

Der folgende Codeausschnitt zeigt einen Verstoß gegen CA2264:

static void Print(int value)
{
    ArgumentNullException.ThrowIfNull(value);
    Console.WriteLine(value);
}

Der folgende Codeausschnitt korrigiert die Verletzung:

static void Print(int value)
{
    Console.WriteLine(value.Value);
}

Wann sollten Warnungen unterdrückt werden?

Es ist immer sicher, diese Warnung zu unterdrücken.

Unterdrücken einer Warnung

Um nur eine einzelne Verletzung zu unterdrücken, fügen Sie der Quelldatei Präprozessoranweisungen hinzu, um die Regel zu deaktivieren und dann wieder zu aktivieren.

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

Um die Regel für eine Datei, einen Ordner oder ein Projekt zu deaktivieren, legen Sie den Schweregrad in der Konfigurationsdatei auf none fest.

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

Weitere Informationen finden Sie unter Vorgehensweise: Unterdrücken von Codeanalyse-Warnungen.

Share via