使用集合初始化表示式或表示式 （IDE0028）
| 財產 | 價值 |
|---|---|
| 規則標識碼 | IDE0028 |
| 標題 | 使用集合初始化表達式 |
| 類別 | 風格 |
| 子類別 | 語言規則 （運算式層級喜好設定） |
| 適用的語言 | C# 和 Visual Basic |
| 選項 | dotnet_style_collection_initializer |
dotnet_style_prefer_collection_expression |
概述
此樣式規則涉及使用 集合初始化表達式，而且如果您使用 C# 12 或更新版本，集合表達式 進行集合初始化。
在 .NET 8 （C# 12） 和更新版本中，如果您已將 dotnet_style_prefer_collection_expression 選項設定為 true，則 Visual Studio 中的 程式代碼修正 會將集合初始化程式代碼轉換為使用集合表達式 （List<int> list = [1, 2, 3];）。 在 Visual Basic 和 .NET 7 （C# 11） 和舊版中，程式代碼修正 將程式代碼轉換成使用集合初始化表達式 （List<int> list = new List<int> { 1, 2, 3 };）。
注意
如果您在 Visual Studio 中使用 程式代碼修正，在某些情況下，它所提供的變更可能會有不同的語意。 例如，int[] x = new int[] { } 會取代為 int[] x = [];，其語意稍有不同，編譯程式會使用單一 x，而不是建立新的實例。
選項
設定此規則相關聯選項的值，以指定初始化集合初始化表達式和集合運算式在初始化集合時是否慣用。
如需設定選項的詳細資訊，請參閱
dotnet_style_collection_initializer
| 財產 | 價值 | 描述 |
|---|---|---|
| 選項名稱 | dotnet_style_collection_initializer | |
| 選項值 | true |
偏好使用集合初始化表達式。 |
false |
不要偏好集合初始化表達式。 | |
| 預設選項值 | true |
dotnet_style_prefer_collection_expression （僅限 C#）
| 財產 | 價值 | 描述 |
|---|---|---|
| 選項名稱 | dotnet_style_prefer_collection_expression | |
| 選項值 | true |
偏好使用集合表達式。 |
false |
不要偏好集合表達式。 | |
| 預設選項值 | true |
例子
// IDE0028 violation.
List<int> list = new List<int>();
list.Add(1);
list.Add(2);
list.Add(3);
// Fixed code (with dotnet_style_prefer_collection_expression = true)
List<int> list = [1, 2, 3];
' IDE0028 violation.
Dim list = New List(Of Integer)
list.Add(1)
list.Add(2)
list.Add(3)
' Fixed code.
Dim list = New List(Of Integer) From {1, 2, 3}
隱藏警告
如果您想要只隱藏單一違規，請將預處理器指示詞新增至原始程式檔以停用，然後重新啟用規則。
#pragma warning disable IDE0028
// The code that's violating the rule is on this line.
#pragma warning restore IDE0028
若要停用檔案、資料夾或項目的規則，請將其嚴重性設定為 組態檔中的 none。
[*.{cs,vb}]
dotnet_diagnostic.IDE0028.severity = none
若要停用所有程式碼樣式規則，請將類別 Style 的嚴重性設定為 組態檔中的 none。
[*.{cs,vb}]
dotnet_analyzer_diagnostic.category-Style.severity = none
如需詳細資訊，請參閱 如何在隱藏程式代碼分析警告。
