本文介绍两个相关规则,IDE0078 和 IDE0260。
| 财产 | 价值 |
|---|---|
| 规则 ID | IDE0078 |
| 标题 | 使用模式匹配 |
| 类别 | 样式 |
| 子类别 | 语言规则(模式匹配首选项) |
| 适用的语言 | C# 9.0+ |
| 选项 | csharp_style_prefer_pattern_matching |
| 财产 | 价值 |
|---|---|
| 规则 ID | IDE0260 |
| 标题 | 使用模式匹配 |
| 类别 | 样式 |
| 子类别 | 语言规则(模式匹配首选项) |
| 适用的语言 | 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
有关详细信息,请参阅 如何取消代码分析警告。