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 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 nullable Structs (mit Ausnahme Nullable<T>), Typparameter, die als nicht nullwerte Structs bekannt sind, 'nameof()'-Ausdrücke und 'neue' Ausdrücke sind bekannt, dass sie niemals null sind, sodass ArgumentNullException.ThrowIfNull sie niemals 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.
