Поделиться через

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

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

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

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

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

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

См. также