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

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

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

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

财产	价值
规则 ID	IDE0270
标题	可以简化 Null 检查（如果进行 null 检查）
类别	样式
子类别	语言规则（表达式级首选项）
适用的语言	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 是 可为空值类型 或 可为空引用类型时，此规则可以建议 x ?? y 而不是 x != null ? x : y。

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

选项

选项指定希望规则强制实施的行为。 有关配置选项的信息，请参阅 选项格式。

dotnet_style_coalesce_expression

财产	价值	描述
选项名称	dotnet_style_coalesce_expression
选项值	true	首选空合并表达式。
	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

有关详细信息，请参阅 如何取消代码分析警告。

另请参阅

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