パターン マッチングを使用する (IDE0078 および IDE0260)

  • [アーティクル]

この記事では、IDE0078 と IDE0260 という 2 つの関連するルールについて説明します。

プロパティ 値
ルール ID IDE0078
Title パターン マッチングの使用
カテゴリ スタイル
Subcategory 言語規則 (パターン マッチング設定)
該当言語 C# 9.0+
[オプション] csharp_style_prefer_pattern_matching
プロパティ 値
ルール ID IDE0260
Title パターン マッチングの使用
カテゴリ スタイル
Subcategory 言語規則 (パターン マッチング設定)
該当言語 C#
[オプション] csharp_style_pattern_matching_over_as_with_null_check

概要

このスタイル規則は、C# パターン マッチングコンストラクトの使用に関するものです。

IDE0260 では、null 条件演算子経由で読み取ったメンバーに続いて as 式の使用に特別なフラグを設定します。 この規則は IDE0019 に似ています。null チェックに続いて as 式の使用にフラグを設定します。

オプション

オプションでは、規則を適用する動作を指定します。 オプションの構成の詳細については、「オプションの書式」を参照してください。

csharp_style_prefer_pattern_matching (IDE0078)

プロパティ 値 説明
オプション名 csharp_style_prefer_pattern_matching
オプションの値 true 可能な場合は、パターン マッチング コンストラクトを使用します
false パターン マッチング コンストラクトを使用しません。
既定のオプションの値 true

csharp_style_pattern_matching_over_as_with_null_check (IDE0260)

このオプションでは、規則 IDE0019 も構成されます。

プロパティ 値 説明
オプション名 csharp_style_pattern_matching_over_as_with_null_check
オプションの値 true null 条件付きメンバー アクセスを持つ as 式よりもパターン マッチングを優先します。
false ルールを無効にします。
既定のオプションの値 true

例

IDE0078

// csharp_style_prefer_pattern_matching = true
var x = i is default(int) or > (default(int));
var y = o is not C c;

// csharp_style_prefer_pattern_matching = false
var x = i == default || i > default(int);
var y = !(o is C c);

IDE0260

// Code with violations.
object? o = null;
if ((o as string)?.Length == 0)
{
}

// Fixed code (csharp_style_pattern_matching_over_as_with_null_check = true).
object? o = null;
if (o is string { Length: 0 })
{
}

警告を抑制する

単一の違反だけを抑制する場合は、ソース ファイルにプリプロセッサ ディレクティブを追加して無効にしてから、規則を再度有効にします。

#pragma warning disable IDE0078 // or IDE0260
// The code that's violating the rule is on this line.
#pragma warning restore IDE0078 // or IDE0260

ファイル、フォルダー、またはプロジェクトのルールを無効にするには、構成ファイルでその重要度を none に設定します。

[*.{cs,vb}]
dotnet_diagnostic.IDE0078.severity = none
dotnet_diagnostic.IDE0260.severity = none

すべてのコード スタイル規則を無効にするには、構成ファイルでカテゴリ Style の重要度を none に設定します。

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

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

関連項目