Freigeben über


Nullüberprüfung kann vereinfacht werden (IDE0029, IDE0030 und IDE0270)

In diesem Artikel werden drei verwandte Regeln, IDE0029, IDE0030und IDE0270beschrieben.

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 von x != null ? x : y empfehlen, wenn x und y nicht nullfähige Verweistypen sind.
  • IDE0030: wird verwendet, wenn Nullable-Ausdrücke beteiligt sind. Diese Regel könnte beispielsweise x ?? y anstelle von x != null ? x : y empfehlen, wenn es sich bei x und y 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.

Siehe auch