null チェックは簡略化できます (IDE0029、IDE0030、IDE0270)

  • [アーティクル]

この記事では、IDE0029、IDE0030、IDE0270 という 3 つの関連するルールについて説明します。

プロパティ 値
ルール ID IDE0029
Title null チェックを簡略化できます (三項条件付きチェック)
カテゴリ スタイル
Subcategory 言語規則 (式レベル基本設定)
該当言語 C# および Visual Basic
[オプション] dotnet_style_coalesce_expression
プロパティ 値
ルール ID IDE0030
Title null チェックを簡略化できます (null 許容三項条件付きチェック)
カテゴリ スタイル
Subcategory 言語規則 (式レベル基本設定)
該当言語 C# および Visual Basic
[オプション] dotnet_style_coalesce_expression
プロパティ 値
ルール ID IDE0270
タイトル null チェックは簡略化できます (null チェックの場合)
カテゴリ スタイル
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 != null ? x : y の代わりに x ?? y を使用することをお勧めします。
  • IDE0030: Null 許容式が含まれる場合に使用します。 たとえば、このルールでは x と y が Null 許容値型または Null 許容参照型である場合に、x != null ? x : y の代わりに x ?? y を使用することをお勧めします。

規則 IDE0270 では、null 合体演算子 (??) ではなく、null チェック (== null または is 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

詳細については、「コード分析の警告を抑制する方法」を参照してください。

関連項目