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

Статья
01/31/2024

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

Обзор

Это правило помечает, где коллекция строится с помощью текучих методов, то есть, где методы, например Add(), AddRange(), AsSpan()и ToList()ToArray() цепочки. Вместо этого можно использовать выражение коллекции для инициализации коллекции. Например, x.AddRange(y).Add(z).AsSpan() преобразуется в [x, ..y, z].

Параметры

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

dotnet_style_prefer_collection_expression

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

^*Исправление кода при использовании этого параметра может изменить семантику кода.

Пример

// Code with violation.
List<int> i = new[] { 1, 2, 3 }.ToList();
IEnumerable<int> j = new[] { 1, 2, 3 }.ToList();

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

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

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

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

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

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

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

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

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

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