Использование инициализаторов или выражений коллекции (IDE0028)

Мақала
12/14/2023

Свойство	Значение
Идентификатор правила	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

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

Бөлісу құралы: