Использование инициализаторов или выражений коллекции (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}
// 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

Чтобы отключить все правила стиля кода, задайте уровень серьезности для категории Stylenone в файле конфигурации.

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

Дополнительные сведения см. в разделе Практическое руководство. Скрытие предупреждений анализа кода.

См. также