Freigeben über

NULL-Überprüfung verwenden (IDE0041)

  • Artikel
Eigentum Wert
Regel-ID IDE0041
Titel NULL-Überprüfung verwenden
Kategorie Stil
Unterkategorie Sprachregeln (Präferenzen auf Ausdrucksebene)
Anwendbare Sprachen C# und Visual Basic
Eingeführte Version Visual Studio 2017
Optionen dotnet_style_prefer_is_null_check_over_reference_equality_method

Überblick

Diese Stilregel betrifft die Verwendung einer NULL-Überprüfung mit Musterabgleich im Vergleich zum Verwenden des Gleichheitsoperators (==) oder aufrufen Object.ReferenceEquals(Object, Object).

Optionen

Optionen geben das Verhalten an, das die Regel erzwingen soll. Informationen zum Konfigurieren von Optionen finden Sie unter Option format.

dotnet_style_prefer_is_null_check_over_reference_equality_method

Eigentum Wert Beschreibung
Optionsname dotnet_style_prefer_is_null_check_over_reference_equality_method
Optionswerte true Lieber is null überprüfen
false Referenzgleichheitsmethode bevorzugen
Standardwert der Option true 
// dotnet_style_prefer_is_null_check_over_reference_equality_method = true
if (value is null)
    return;

// dotnet_style_prefer_is_null_check_over_reference_equality_method = false
if (object.ReferenceEquals(value, null))
    return;

// dotnet_style_prefer_is_null_check_over_reference_equality_method = false
if ((object)o == null)
    return;

' dotnet_style_prefer_is_null_check_over_reference_equality_method = true
If value Is Nothing
    Return
End If

' dotnet_style_prefer_is_null_check_over_reference_equality_method = false
If Object.ReferenceEquals(value, Nothing)
    Return
End If

' dotnet_style_prefer_is_null_check_over_reference_equality_method = false
If CType(value, Object) = Nothing
    Return
End If

Unterdrücken einer Warnung

Wenn Sie nur einen einzelnen Verstoß unterdrücken möchten, fügen Sie Ihrer Quelldatei Präprozessordirektiven hinzu, um die Regel zu deaktivieren und dann erneut zu aktivieren.

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

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

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

Um alle Regeln im Code-Stil zu deaktivieren, setzen Sie den Schweregrad für die Kategorie in der KonfigurationsdateiStyle auf none.

[*.{cs,vb}]
dotnet_analyzer_diagnostic.category-Style.severity = none

Weitere Informationen finden Sie unter So unterdrücken Sie Codeanalysewarnungen.

Siehe auch