'var' 喜好設定 （IDE0007 和 IDE0008）

本文說明兩個相關規則，IDE0007 和 IDE0008。

財產	價值
規則標識碼	IDE0007
標題	使用 var 而非明確類型
類別	風格
子類別	語言規則 （'var' 喜好設定）
適用的語言	C#
選項	csharp_style_var_for_built_in_types
	csharp_style_var_when_type_is_apparent
	csharp_style_var_elsewhere

財產	價值
規則標識碼	IDE0008
標題	使用明確類型，而不是使用 var
類別	風格
子類別	語言規則 （'var' 喜好設定）
適用的語言	C#
選項	csharp_style_var_for_built_in_types
	csharp_style_var_when_type_is_apparent
	csharp_style_var_elsewhere

概述

這兩個樣式規則會定義變數宣告中是否應該使用 var 關鍵詞或明確類型。 若要強制使用 var，請將 IDE0007 的嚴重性設定為警告或錯誤。 若要強制使用明確類型，請將 IDE0008 的嚴重性設定為警告或錯誤。

選項

此規則的相關選項會定義應該套用此樣式喜好設定的位置：

• 內建類型 （csharp_style_var_for_built_in_types）
• 類型明顯的位置 （csharp_style_var_when_type_is_apparent）
• 其他地方 （csharp_style_var_elsewhere）

如需設定選項的詳細資訊，請參閱 選項格式。

C# 內建類型使用 var 風格

財產	價值	描述
選項名稱	csharp_style_var_for_built_in_types
選項值	true	偏好使用 var 來宣告具有內建系統類型的變數，例如 int
	false	偏好使用明確類型而不是 var 來宣告具有內建系統類型的變數，例如 int
預設選項值	false

// csharp_style_var_for_built_in_types = true
var x = 5;

// csharp_style_var_for_built_in_types = false
int x = 5;

csharp_style_var_when_type_is_apparent

財產	價值	描述
選項名稱	csharp_style_var_當類型明顯時
選項值	true	當在宣告表達式的右側已經提到類型時，建議使用 var。
	false	當宣告表達式右側已提及類型時，偏好使用明確的類型
預設選項值	false

// csharp_style_var_when_type_is_apparent = true
var obj = new Customer();

// csharp_style_var_when_type_is_apparent = false
Customer obj = new Customer();

csharp_style_var_elsewhere

財產	價值	描述
選項名稱	csharp_style_var_elsewhere
選項值	true	除非受另一程式碼風格規則覆蓋，否則應在所有場合偏好使用 var 而不是具體類型。
	false	除非由另一個程式代碼樣式規則覆寫，否則在所有情況下，偏好明確類型而不是 var
預設選項值	false

// csharp_style_var_elsewhere = true
var f = this.Init();

// csharp_style_var_elsewhere = false
bool f = this.Init();

隱藏警告

如果您想要只隱藏單一違規，請將預處理器指示詞新增至原始程式檔以停用，然後重新啟用規則。

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

若要停用檔案、資料夾或項目的規則，請將其嚴重性設定為 組態檔中的 none。

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

若要停用所有程式碼樣式規則，請將類別 Style 的嚴重性設定為 組態檔中的 none。

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

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

另請參閱

• var 關鍵詞
• 程式代碼樣式語言規則
• 程式代碼樣式規則參考