使用模式匹配来避免后跟强制转换的“is”检查(IDE0020 和 IDE0038)

本文介绍两个相关规则,IDE0020IDE0038

财产 价值
规则 ID IDE0020
标题 使用模式匹配来避免后跟强制转换的 is 检查(带变量)
类别 样式
子类别 语言规则(模式匹配首选项)
适用的语言 C#
选项 csharp_style_pattern_matching_over_is_with_cast_check
财产 价值
规则 ID IDE0038
标题 使用模式匹配来避免后跟强制转换的 is 检查(不带变量)
类别 样式
子类别 语言规则(模式匹配首选项)
适用的语言 C#
选项 csharp_style_pattern_matching_over_is_with_cast_check

概述

此样式规则涉及使用 C# 模式匹配(例如 o is int i),而不是后跟强制转换的 is 检查(例如 if (o is int) { ... (int)o ... })。 根据强制转换表达式是否应保存在单独的局部变量中,启用 IDE0020IDE0038

  • 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

有关详细信息,请参阅 如何取消代码分析警告

另请参阅