Использование выражения коллекции для массива (IDE0300)

  • Статья
Свойство Значение
Идентификатор правила IDE0300
Заголовок Использование выражения коллекции для массива
Категория Стиль
Подкатегории Правила языка (настройки уровня выражения)
Применимые языки C# 12+
Параметры dotnet_style_prefer_collection_expression

Обзор

Это правило помечает, где выражение коллекции может использоваться для инициализации массива. Например, это правило предлагает упростить код, например new C[] { ... }, new[] { ... }и C[] c = { ... } в форме выражения коллекции ([...]).

Параметры

Параметры указывают поведение, которое требуется применить правило. Сведения о настройке параметров см . в разделе "Формат параметров".

dotnet_style_prefer_collection_expression

Свойство Значение Описание
Имя параметра dotnet_style_prefer_collection_expression
Значения параметра true | when_types_exactly_match Предпочитать использовать выражения коллекции только в том случае, если типы соответствуют точно, например int[] i = new int[] { 1, 2, 3 };.
when_types_loosely_match
(.NET 9 и более поздние версии)*		 Предпочитать использовать выражения коллекции, даже если типы соответствуют свободно, например IEnumerable<int> i = new int[] { 1, 2, 3 };. Целевой тип должен соответствовать типу справа или быть одним из следующих типов: IEnumerable<T>, , ICollection<T>IList<T>, . IReadOnlyList<T>IReadOnlyCollection<T>
false | never Отключает проблемное правило.
Значение параметра по умолчанию true в .NET 8
when_types_loosely_match в .NET 9 и более поздних версиях

*Исправление кода при использовании этого параметра может изменить семантику кода. Например, если у вас есть IEnumerable<int> x = new int[] { 1, 2, 3 };, то в исходном коде создается массив. Но в новом коде (IEnumerable<int> x = [1, 2, 3];), вместо этого создается внутренний синтезированный компилятором тип. Это различие можно наблюдать, если вы используете is проверка или приведение.

Пример

// Code with violations.
int[] i = new int[] { 1, 2, 3 };
IEnumerable<int> j = new int[] { 1, 2, 3 };

// Fixed code.
int[] i = [1, 2, 3];
IEnumerable<int> j = [1, 2, 3];

Отключение предупреждений

Если вы хотите отключить только одно нарушение, добавьте директивы препроцессора в исходный файл, чтобы отключить и повторно включить правило.

#pragma warning disable IDE0300
// The code that's violating the rule is on this line.
#pragma warning restore IDE0300

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

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

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

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

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

См. также