使用物件初始設定式 (IDE0017)

屬性	值
規則識別碼	IDE0017
標題	使用物件初始設定式
類別	樣式
子類別	語言規則 (運算式層級喜好設定)
適用語言	C# 和 Visual Basic
選項	dotnet_style_object_initializer

概觀

此樣式規則與使用物件初始設定式進行物件初始化有關。

選項

此規則的選項值會指定是否需要初始設定式。

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

dotnet_style_object_initializer

屬性	值	描述
選項名稱	dotnet_style_object_initializer
選項值	true	偏好盡可能使用物件初始設定式來初始化物件
	false	偏好「不」使用物件初始設定式來初始化物件
預設選項值	true

// dotnet_style_object_initializer = true
var c = new Customer() { Age = 21 };

// dotnet_style_object_initializer = false
var c = new Customer();
c.Age = 21;

' dotnet_style_object_initializer = true
Dim c = New Customer() With {.Age = 21}

' dotnet_style_object_initializer = false
Dim c = New Customer()
c.Age = 21

隱藏警告

若您只想隱藏單一違規，請將前置處理指示詞新增至來源檔案以停用規則，然後重新啟用規則。

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

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

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

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

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

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

另請參閱

• 物件和集合初始設定式 (C# 程式設計手冊)
• IDE0028 - 使用集合初始設定式
• 程式碼樣式語言規則
• 程式碼樣式規則參考