Nullüberprüfung kann vereinfacht werden (IDE0029, IDE0030 und IDE0270)
In diesem Artikel werden drei verwandte Regeln, IDE0029
, IDE0030
und IDE0270
beschrieben.
Eigentum | Wert |
---|---|
Regel-ID | IDE0029 |
Titel | Überprüfung auf Nullwerte kann vereinfacht werden (ternäre bedingte Überprüfung) |
Kategorie | Stil |
Unterkategorie | Sprachregeln (Präferenzen auf Ausdrucksebene) |
Anwendbare Sprachen | C# und Visual Basic |
Optionen | dotnet_style_coalesce_expression |
Eigentum | Wert |
---|---|
Regel-ID | IDE0030 |
Titel | Überprüfung auf Nullwerte kann vereinfacht werden (Nullwerte zulassende ternäre bedingte Überprüfung) |
Kategorie | Stil |
Unterkategorie | Sprachregeln (Präferenzen auf Ausdrucksebene) |
Anwendbare Sprachen | C# und Visual Basic |
Optionen | dotnet_style_coalesce_expression |
Eigentum | Wert |
---|---|
Regel-ID | IDE0270 |
Titel | Überprüfung auf Nullwerte kann vereinfacht werden (bei NULL-Überprüfung) |
Kategorie | Stil |
Unterkategorie | Sprachregeln (Einstellungen auf Ausdrucksebene) |
Anwendbare Sprachen | C# und Visual Basic |
Optionen | dotnet_style_coalesce_expression |
Überblick
Die Regeln IDE0029 und IDE0030 betreffen die Verwendung von NULL-Sammelausdrücken, z. B. x ?? y
, im Gegensatz zu ternären bedingten Ausdrücken mit null
-Überprüfungen, z. B x != null ? x : y
. Die Regeln unterscheiden sich hinsichtlich der Nullierbarkeit der Ausdrücke:
-
IDE0029
: wird verwendet, wenn Non-Nullable-Ausdrücke beteiligt sind. Diese Regel kann z. B.x ?? y
anstelle vonx != null ? x : y
empfehlen, wennx
undy
nicht nullfähige Verweistypen sind. -
IDE0030
: wird verwendet, wenn Nullable-Ausdrücke beteiligt sind. Diese Regel könnte beispielsweisex ?? y
anstelle vonx != null ? x : y
empfehlen, wenn es sich beix
undy
um Nullwerte zulassende Werttypen oder Nullwerte zulassende Verweistypen handelt.
Regel IDE0270 kennzeichnet die Verwendung einer null-Prüfung (== null
oder is null
) anstelle des Null-Koaleszenzoperators (??
).
Optionen
Optionen geben das Verhalten an, das die Regel erzwingen soll. Informationen zum Konfigurieren von Optionen finden Sie unter Option format.
dotnet_style_coalesce_expression
Eigentum | Wert | Beschreibung |
---|---|---|
Name der Option | dotnet_style_coalesce_expression | |
Optionswerte | true |
Bevorzugen Sie Null-Koaleszenz-Ausdrücke. |
false |
Deaktiviert die Regel. | |
Standardwert der Option | true |
Beispiele
IDE0029 und IDE0030
// Code with violation.
var v = x != null ? x : y; // or
var v = x == null ? y : x;
// Fixed code.
var v = x ?? y;
' Code with violation.
Dim v = If(x Is Nothing, y, x) ' or
Dim v = If(x IsNot Nothing, x, y)
' Fixed code.
Dim v = If(x, y)
IDE0270
// Code with violation.
class C
{
void M()
{
var item = FindItem() as C;
if (item == null)
throw new System.InvalidOperationException();
}
object? FindItem() => null;
}
// Fixed code (dotnet_style_coalesce_expression = true).
class C
{
void M()
{
var item = FindItem() as C ?? throw new System.InvalidOperationException();
}
object? FindItem() => null;
}
' Code with violation.
Public Class C
Sub M()
Dim item = TryCast(FindItem(), C)
If item Is Nothing Then
item = New C()
End If
End Sub
Function FindItem() As Object
Return Nothing
End Function
End Class
' Fixed code (dotnet_style_coalesce_expression = true).
Public Class C
Sub M()
Dim item = If(TryCast(FindItem(), C), New C())
End Sub
Function FindItem() As Object
Return Nothing
End Function
End Class
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 IDE0029 // Or IDE0030 or IDE0270
// The code that's violating the rule is on this line.
#pragma warning restore IDE0029 // Or IDE0030 or IDE0270
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.IDE0029.severity = none
dotnet_diagnostic.IDE0030.severity = none
dotnet_diagnostic.IDE0270.severity = none
Um alle Codestilregeln zu deaktivieren, legen Sie den Schweregrad für die Kategorie Style
in der Konfigurationsdateiauf none
fest.
[*.{cs,vb}]
dotnet_analyzer_diagnostic.category-Style.severity = none
Weitere Informationen finden Sie unter So unterdrücken Sie Codeanalysewarnungen.