Freigeben über

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

Eigenschaft Wert
Regel-ID CA2264
Titel Übergeben Sie keinen nicht nullfähigen Wert an ArgumentNullException.ThrowIfNull
Kategorie Verwendung
Fix führt zu Unterbrechungen oder bleibt funktionsfähig Untrennbar
Standardmäßig in .NET 10 aktiviert Als Warnung
Anwendbare Sprachen C# und Visual Basic

Ursache

Ein Wert, von dem bekannt ist, dass er niemals null sein wird, wird an ArgumentNullException.ThrowIfNull() übergeben.

Regelbeschreibung

ArgumentNullException.ThrowIfNull wird ausgelöst, wenn das übergebene Argument nullist . Bestimmte Konstrukte wie nicht-nullbare Strukturen (mit Ausnahme von Nullable<T>), Typparameter, die als nicht-nullbare Strukturen bekannt sind, 'nameof()'-Ausdrücke und 'new'-Ausdrücke sind dafür bekannt, dass sie niemals null sind, sodass ArgumentNullException.ThrowIfNull niemals ausgelöst wird. Daher ist das Aufrufen ArgumentNullException.ThrowIfNull unnötig.

Im Falle einer Struktur, da ArgumentNullException.ThrowIfNull ein object? akzeptiert, wird die Struktur geboxt, was zu einer zusätzlichen Leistungseinbuße führt.

So beheben Sie Verstöße

Entfernen Sie den ArgumentNullException.ThrowIfNull Aufruf.

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 auf none in der Konfigurationsdatei fest.

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

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

Siehe auch

  • Last updated on