Verwenden des Musterabgleichs (not-Operator) (IDE0083)

  • Artikel
Eigenschaft Wert
Regel-ID IDE0083
Titel Musterabgleich verwenden (not-Operator)
Kategorie Stil
Unterkategorie Sprachregeln (Einstellungen für den Musterabgleich)
Gültige Sprachen C# 9.0 oder höher
Optionen csharp_style_prefer_not_pattern

Übersicht

Diese Stilregel bezieht sich auf die Verwendung des not-Musters in C# 9.0, sofern möglich.

Optionen

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

csharp_style_prefer_not_pattern

Eigenschaft Wert Beschreibung
Name der Option csharp_style_prefer_not_pattern
Optionswerte true not-Muster bevorzugen, falls möglich
false -Muster nichtnot bevorzugen
Standardoptionswert true

Hinweis

Bei Festlegung auf false wird die Nutzung des not-Musters im Analysetool nicht markiert. Jedoch wird das not-Muster von generiertem Code nicht verwendet. Bei Festlegung auf true wird Code markiert, der das not-Muster nicht verwendet, und sämtlicher generierte Code verwendet, sofern möglich, das not-Muster.

In den folgenden Beispielen wird veranschaulicht, wie Code von codeerzeugenden Funktionen generiert wird, wenn die Option entweder auf true oder auf false festgelegt ist.

// csharp_style_prefer_not_pattern = true
var y = o is not C c;

// csharp_style_prefer_not_pattern = false
var y = !(o is C c);

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 IDE0083
// The code that's violating the rule is on this line.
#pragma warning restore IDE0083

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.IDE0083.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 Vorgehensweise: Unterdrücken von Codeanalyse-Warnungen.

Siehe auch