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

Статья
02/08/2025

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

Обзор

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

Параметры

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

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

Свойство	Ценность	Описание
имя параметра	csharp_style_prefer_primary_constructors
Значения опции	`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

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

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