在 foreach 迴圈中新增明確轉換 (IDE0220)

屬性	值
規則識別碼	IDE0220
標題	新增明確的轉換
類別	樣式
子類別	語言規則 (運算式層級喜好設定)
適用語言	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

如需詳細資訊，請參閱如何隱藏程式碼分析警告。

另請參閱

• 常用的集合類型
• 程式碼樣式規則參考