使用集合初始化表示式或表示式 （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

屬性 數值 Description
選項名稱 dotnet_style_collection_initializer
選項值 true 偏好使用集合初始化表達式。
false 不要偏好集合初始化表達式。
默認選項值 true

dotnet_style_prefer_collection_expression （僅限 C#）

屬性 數值 Description
選項名稱 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}

// IDE0028 violation.
List<int> list = new List<int>();
list.Add(1);
list.Add(2);
list.Add(3);

// Fixed code.
List<int> list = new List<int>
{
    1,
    2,
    3
};

// IDE0028 violation.
List<int> list = new List<int>();
list.Add(1);
list.AddRange(new[] { 5, 6, 7 });

// Fixed code.
List<int> list = [1, .. new[] { 5, 6, 7 }];

' 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

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

另請參閱