パターン マッチングを使用する (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
詳細については、「コード分析の警告を抑制する方法」を参照してください。
関連項目
GitHub で Microsoft と共同作業する
このコンテンツのソースは GitHub にあります。そこで、issue や pull request を作成および確認することもできます。 詳細については、共同作成者ガイドを参照してください。
.NET