可以简化 Null 检查（IDE0029、IDE0030 和 IDE0270）

本文介绍了两个相关的规则：IDE0029、IDE0030 和 IDE0270。

属性	值
规则 ID	IDE0029
标题	Null 检查可以简化（三元条件检查）
类别	Style
Subcategory	语言规则（表达式级首选项）
适用的语言	C# 和 Visual Basic
选项	dotnet_style_coalesce_expression

属性	值
规则 ID	IDE0030
标题	Null 检查可以简化（可为 null 的三元条件检查）
类别	Style
Subcategory	语言规则（表达式级首选项）
适用的语言	C# 和 Visual Basic
选项	dotnet_style_coalesce_expression

属性	值
规则 ID	IDE0270
标题	可以简化 Null 检查（如果进行 null 检查）
类别	Style
Subcategory	语言规则（表达式级首选项）
适用的语言	C# 和 Visual Basic
选项	dotnet_style_coalesce_expression

概述

IDE0029 和 IDE0030 规则涉及使用 null 合并表达式（例如 x ?? y），与使用 null 检查的三元条件表达式（例如 x != null ? x : y）形成对比。 这些规则在表达式的可为 null 性方面存在差异：

• IDE0029：在涉及不可为 null 的表达式时使用。 例如，当 x 和 y 是不可为 null 的引用类型时，此规则可能会建议使用 x ?? y 而不是 x != null ? x : y。
• IDE0030：在涉及可为 null 的表达式时使用。 例如，当 x 和 y 是可为 null 的值类型或可为 null 的引用类型时，此规则可能会建议使用 x ?? y 而不是 x != null ? x : y。

规则 IDE0270 标记使用 null 检查 (== null 或 is null) 而不是 null 合并运算符 (??)。

选项

选项指定你希望规则强制实施的行为。 若要了解如何配置选项，请参阅选项格式。

dotnet_style_coalesce_expression

属性	值	说明
选项名称	dotnet_style_coalesce_expression
选项值	true	首选 null 合并表达式。
	false	禁用规则。
默认选项值	true

示例

IDE0029 和 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

抑制警告

如果只想抑制单个冲突，请将预处理器指令添加到源文件以禁用该规则，然后重新启用该规则。

#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

若要对文件、文件夹或项目禁用该规则，请在配置文件中将其严重性设置为 none。

[*.{cs,vb}]
dotnet_diagnostic.IDE0029.severity = none
dotnet_diagnostic.IDE0030.severity = none
dotnet_diagnostic.IDE0270.severity = none

若要禁用所有代码样式规则，请在配置文件中将类别 Style 的严重性设置为 none。

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

有关详细信息，请参阅如何禁止显示代码分析警告。

另请参阅

• 代码样式语言规则
• 代码样式规则参考