Verwenden Sie den primären Konstruktor (IDE0290)

Eigentum	Wert
Regel-ID	IDE0290
Titel	Primären Konstruktor verwenden
Kategorie	Stil
Unterkategorie	Sprachregeln (Einstellungen für Code-Blöcke)
Anwendbare Sprachen	C# 12+
Optionen	csharp_style_prefer_primary_constructors

Überblick

Diese Regel kennzeichnet Klassen, die einen primären Konstruktor anstelle einer separaten Konstruktordefinition verwenden können. Sie definieren einen primären Konstruktor, indem Sie alle Konstruktorparameter in Klammern nach dem Typnamen platzieren. Ein primärer Konstruktor gibt an, dass diese Parameter für jede Instanz des Typs erforderlich sind.

Wenn Sie eine Klasse oder Struktur mit mehreren Konstruktoren erstellen, erhalten Sie Flexibilität, aber sie fügen auch ausführliche Syntax hinzu. Sie müssen die Konstruktoreingabe sauber vom Klassenzustand trennen. Bei primären Konstruktoren können Sie die Parameter eines Konstruktors im Bereich für die gesamte Klasse oder Struktur platzieren. Sie können diese Parameter für die Initialisierung oder direkt als Objektzustand verwenden. Wenn Sie jedoch andere Konstruktoren hinzufügen, müssen sie den primären Konstruktor aufrufen.

Optionen

Optionen geben das Verhalten an, das die Regel erzwingen soll. Informationen zum Konfigurieren von Optionen finden Sie unter Option format.

csharp_style_prefer_primary_constructors

Eigentum	Wert	Beschreibung
Optionenname	csharp_style_prefer_primary_constructors
Optionswerte	true	Verwende lieber primäre Konstruktoren.
	false	Deaktiviert die Regel.
Standardoptionenwert	true

Beispiel

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

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

Unterdrücken einer Warnung

Wenn Sie nur einen einzelnen Verstoß unterdrücken möchten, fügen Sie Ihrer Quelldatei Präprozessordirektiven hinzu, um die Regel zu deaktivieren und dann erneut zu aktivieren.

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

Um die Regel für eine Datei, einen Ordner oder ein Projekt zu deaktivieren, legen Sie den Schweregrad in der noneauf fest.

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

Um alle Codestilregeln zu deaktivieren, legen Sie den Schweregrad für die Kategorie von Style in der noneauf fest.

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

Weitere Informationen finden Sie unter So unterdrücken Sie Codeanalysewarnungen.