Überprüfung auf Nullwerte kann vereinfacht werden (IDE0029, IDE0030 und IDE0270)

  • Artikel

In diesem Artikel werden drei verwandte Regeln beschrieben: IDE0029, IDE0030 und IDE0270.

Eigenschaft Wert
Regel-ID IDE0029
Titel Überprüfung auf Nullwerte kann vereinfacht werden (ternäre bedingte Überprüfung)
Kategorie Stil
Unterkategorie Sprachregeln (Einstellungen auf Ausdrucksebene)
Gültige Sprachen C# und Visual Basic
Optionen dotnet_style_coalesce_expression
Eigenschaft Wert
Regel-ID IDE0030
Titel Überprüfung auf Nullwerte kann vereinfacht werden (Nullwerte zulassende ternäre bedingte Überprüfung)
Kategorie Stil
Unterkategorie Sprachregeln (Einstellungen auf Ausdrucksebene)
Gültige Sprachen C# und Visual Basic
Optionen dotnet_style_coalesce_expression
Eigenschaft Wert
Regel-ID IDE0270
Titel Überprüfung auf Nullwerte kann vereinfacht werden (bei NULL-Überprüfung)
Kategorie Stil
Unterkategorie Sprachregeln (Einstellungen auf Ausdrucksebene)
Gültige Sprachen C# und Visual Basic
Optionen dotnet_style_coalesce_expression

Übersicht

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 beiden verwandten Regeln unterscheiden sich in Bezug darauf, ob die Ausdrücke Nullwerte zulassen:

  • IDE0029: wird verwendet, wenn Ausdrücke beteiligt sind, die keine Nullwerte zulassen. Diese Regel könnte beispielsweise x ?? y anstelle von x != null ? x : y empfehlen, wenn x und y Verweistypen sind, die keine Nullwerte zulassen.
  • IDE0030: wird verwendet, wenn Ausdrücke beteiligt sind, die Nullwerte zulassen. 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.

Die Regel IDE0270 kennzeichnet die Verwendung einer Überprüfung auf Nullwerte (== null oder is null) anstelle des NULL-Sammeloperators (??).

Optionen

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

dotnet_style_coalesce_expression

Eigenschaft value Beschreibung
Name der Option dotnet_style_coalesce_expression
Optionswerte true Sie sollten Ausdrücke mit dem Sammeloperator verwenden.
false Die Regel wird deaktiviert.
Standardoptionswert 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

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 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 Konfigurationsdatei auf none fest.

[*.{cs,vb}]
dotnet_diagnostic.IDE0029.severity = none
dotnet_diagnostic.IDE0030.severity = none
dotnet_diagnostic.IDE0270.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