Использование основного конструктора (IDE0290)

Свойство	Ценность
идентификатор правила	IDE0290
Заголовок	Используйте основной конструктор
категория	Стиль
Подкатегория	Языковые правила (настройки блока кода)
применимые языки	C# 12+
Опции	csharp_style_prefer_primary_constructors

Обзор

Это правило помечает классы, которые могут использовать основной конструктор вместо отдельного определения конструктора. Вы определяете основной конструктор, помещая все параметры конструктора в скобки после имени типа. Основной конструктор указывает, что эти параметры необходимы для любого экземпляра типа.

При создании класса или структуры с несколькими конструкторами вы получаете гибкость, но также добавляется подробный синтаксис. Необходимо четко разделить входные данные конструктора от состояния класса. С помощью основных конструкторов можно поместить параметры одного конструктора в область действия для всего класса или структуры. Эти параметры можно использовать для инициализации или непосредственно в качестве состояния объекта. Однако при добавлении других конструкторов они должны вызываться через основной конструктор.

Параметры

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

csharp_style_prefer_primary_constructors (предпочтение использования основных конструкторов в стиле C#)

Свойство	Ценность	Описание
имя параметра	csharp_style_prefer_primary_constructors (предпочтение использования основных конструкторов в стиле C#)
Значения опции	true	Предпочтительно использовать первичные конструкторы.
	false	Отключает правило.
значение параметра по умолчанию	true

Пример

// Code with violations.
class C
{
    public C(int i) { }
}

// Fixed code.
class C(int i)
{
}

Подавление предупреждения

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

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

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

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

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

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

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