在 foreach 循环中添加显式强制转换 (IDE0220)

属性	值
规则 ID	IDE0220
标题	添加显式强制转换
类别	Style
Subcategory	语言规则（表达式级首选项）
适用的语言	C#
选项	dotnet_style_prefer_foreach_explicit_cast_in_source

概述

当编译器添加隐藏强制转换时，此规则将标记 foreach 循环中缺少显式强制转换。 对于泛型或强类型化集合，当编译器添加隐藏强制转换时强制添加显式强制转换可能会发现 foreach 语句中使用了不正确的类型。

选项

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

dotnet_style_prefer_foreach_explicit_cast_in_source

属性	值	说明
选项名称	dotnet_style_prefer_foreach_explicit_cast_in_source
选项值	always	在源代码中首选显式强制转换。
	when_strongly_typed	对于强类型化（泛型）集合，首选显式强制转换，但这不适用于旧集合，例如 ArrayList。
默认选项值	when_strongly_typed

示例

// Code with violations.
var list = new List<object>();
foreach (string item in list) { }

// Fixed code.
var list = new List<object>();
foreach (string item in list.Cast<string>())

抑制警告

如果只想抑制单个冲突，请将预处理器指令添加到源文件以禁用该规则，然后重新启用该规则。

#pragma warning disable IDE0220
// The code that's violating the rule is on this line.
#pragma warning restore IDE0220

若要对文件、文件夹或项目禁用该规则，请在配置文件中将其严重性设置为 none。

[*.{cs,vb}]
dotnet_diagnostic.IDE0220.severity = none

若要禁用所有代码样式规则，请在配置文件中将类别 Style 的严重性设置为 none。

[*.{cs,vb}]
dotnet_analyzer_diagnostic.category-Style.severity = none

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

另请参阅

• 常用的集合类型
• 代码样式规则参考