使用模式匹配来避免后跟强制转换的“is”检查(IDE0020 和 IDE0038)
本文介绍两个相关的规则:IDE0020
和 IDE0038
。
属性 | 值 |
---|---|
规则 ID | IDE0020 |
标题 | 使用模式匹配来避免后跟强制转换的 is 检查(带变量) |
类别 | Style |
Subcategory | 语言规则(模式匹配首选项) |
适用的语言 | C# |
选项 | csharp_style_pattern_matching_over_is_with_cast_check |
属性 | 值 |
---|---|
规则 ID | IDE0038 |
标题 | 使用模式匹配来避免后跟强制转换的 is 检查(不带变量) |
类别 | Style |
Subcategory | 语言规则(模式匹配首选项) |
适用的语言 | C# |
选项 | csharp_style_pattern_matching_over_is_with_cast_check |
概述
此样式规则涉及使用 C# 模式匹配(例如 o is int i
),而不是后跟强制转换的 is
检查(例如 if (o is int) { ... (int)o ... }
)。 根据强制转换表达式是否应保存在单独的局部变量中,启用 IDE0020
或 IDE0038
:
IDE0020
:强制转换表达式保存到局部变量中。 例如,if (o is int) { var i = (int)o; }
将(int)o
的结果保存在局部变量中。IDE0038
:强制转换表达式不保存到局部变量中。 例如,if (o is int) { if ((int)o == 1) { ... } }
不将(int)o
的结果保存到局部变量中。
选项
设置此规则的关联选项的值,以指定是首选模式匹配还是首选 is
检查后跟类型强制转换。
若要详细了解如何配置选项,请参阅选项格式。
csharp_style_pattern_matching_over_is_with_cast_check
属性 | 价值 | 说明 |
---|---|---|
选项名称 | csharp_style_pattern_matching_over_is_with_cast_check | |
选项值 | true |
倾向于使用模式匹配,而不是带类型强制转换的 is 表达式。 |
false |
禁用规则。 | |
默认选项值 | true |
// csharp_style_pattern_matching_over_is_with_cast_check = true
if (o is int i) {...}
// csharp_style_pattern_matching_over_is_with_cast_check = false
if (o is int) {var i = (int)o; ... }
抑制警告
如果只想抑制单个冲突,请将预处理器指令添加到源文件以禁用该规则,然后重新启用该规则。
#pragma warning disable IDE0020 // Or IDE0038
// The code that's violating the rule is on this line.
#pragma warning restore IDE0020 // Or IDE0038
若要对文件、文件夹或项目禁用该规则,请在配置文件中将其严重性设置为 none
。
[*.{cs,vb}]
dotnet_diagnostic.IDE0020.severity = none
dotnet_diagnostic.IDE0038.severity = none
若要禁用所有代码样式规则,请在配置文件中将类别 Style
的严重性设置为 none
。
[*.{cs,vb}]
dotnet_analyzer_diagnostic.category-Style.severity = none
有关详细信息,请参阅如何禁止显示代码分析警告。