Упрощение шаблона свойств (IDE0170)

Статья
07/25/2023

Свойство	Значение
Идентификатор правила	IDE0170
Заголовок	Упрощение шаблона свойств
Категория	Стиль
Подкатегория	Правила языка (параметры сопоставления шаблонов)
Применимые языки	C#
Параметры	`csharp_style_prefer_extended_property_pattern`

Общие сведения

Это правило стиля помечает использование вложенного шаблона в шаблоне свойств. Вложенный шаблон можно упростить, используя расширенный шаблон свойств, в котором подшаблицы свойств используются для ссылки на вложенные члены. Расширенные шаблоны свойств повышают удобочитаемость кода.

Варианты

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

csharp_style_prefer_extended_property_pattern

Свойство	Значение	Описание
Имя параметра	csharp_style_prefer_extended_property_pattern
Значения параметра	`true`	Предпочитать шаблон расширенного свойства.
	`false`	Отключает проблемное правило.
Значение параметра по умолчанию	`true`

Пример

public record Point(int X, int Y);
public record Segment(Point Start, Point End);

// Violates IDE0170.
static bool IsEndOnXAxis(Segment segment) =>
    segment is { Start: { Y: 0 } } or { End: { Y: 0 } };

// Fixed code.
static bool IsEndOnXAxis(Segment segment) =>
    segment is { Start.Y: 0 } or { End.Y: 0 };

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

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

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

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

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

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

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

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

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