使用模式匹配 (IDE0078 和 IDE0260)

项目
07/28/2023

本文介绍了两个相关的规则：IDE0078 和 IDE0260。

属性	值
规则 ID	IDE0078
标题	使用模式匹配
类别	Style
Subcategory	语言规则（模式匹配首选项）
适用的语言	C# 9.0+
选项	`csharp_style_prefer_pattern_matching`

属性	值
规则 ID	IDE0260
标题	使用模式匹配
类别	Style
Subcategory	语言规则（模式匹配首选项）
适用的语言	C#
选项	`csharp_style_pattern_matching_over_as_with_null_check`

概述

此样式规则涉及到使用 C# 模式匹配构造。

IDE0260 专门标记 as表达式的使用，后跟通过 null 条件运算符读取的成员。此规则类似于 IDE0019，它标记使用 as 的表达式后跟的 null 检查。

选项

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

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`	首选模式匹配，而不是`as`具有 null 条件成员访问的表达式。
	`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

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