„var“-Einstellungen (IDE0007 und IDE0008)

Artikel
02/12/2025

In diesem Artikel werden zwei verwandte Regeln, IDE0007 und IDE0008beschrieben.

Eigentum	Wert
Regel-ID	IDE0007
Titel	Verwenden von `var` anstelle eines expliziten Typs
Kategorie	Stil
Unterkategorie	Sprachregeln ('var'-Präferenzen)
Anwendbare Sprachen	C#
Optionen	`csharp_style_var_for_built_in_types`
	`csharp_style_var_when_type_is_apparent`
	`csharp_style_var_elsewhere`

Eigentum	Wert
Regel-ID	IDE0008
Titel	Verwenden Sie expliziten Typ anstelle von `var`
Kategorie	Stil
Unterkategorie	Sprachregeln ("var"-Einstellungen)
Anwendbare Sprachen	C#
Optionen	`csharp_style_var_for_built_in_types`
	`csharp_style_var_when_type_is_apparent`
	`csharp_style_var_elsewhere`

Überblick

Diese beiden Stilregeln definieren, ob das Var--Schlüsselwort oder ein expliziter Typ in einer Variablendeklaration verwendet werden soll. Um zu erzwingen, dass var verwendet wird, legen Sie den Schweregrad IDE0007 auf Warnung oder Fehler fest. Um zu erzwingen, dass der explizite Typ verwendet wird, legen Sie den Schweregrad von IDE0008 auf Warnung oder Fehler fest.

Optionen

Die zugehörigen Optionen dieser Regel bestimmen, wo diese Stilpräferenz angewendet werden sollte.

Integrierte Typen (csharp_style_var_for_built_in_types)
Stellen, an denen der Typ sichtbar ist (csharp_style_var_when_type_is_apparent)
Anderswo (csharp_style_var_elsewhere)

Weitere Informationen zum Konfigurieren von Optionen finden Sie unter Optionsformat.

csharp_style_var_for_built_in_types

Eigentum	Wert	Beschreibung
Optionsbezeichnung	csharp_style_var_for_built_in_types
Optionswerte	`true`	Es wird empfohlen, dass `var` verwendet wird, um Variablen mit integrierten Systemtypen wie `int` anzulegen.
	`false`	Bevorzugen Sie einen expliziten Typ über `var` zum Deklarieren von Variablen mit integrierten Systemtypen wie `int`.
Standardoptionwert	`false`

// csharp_style_var_for_built_in_types = true
var x = 5;

// csharp_style_var_for_built_in_types = false
int x = 5;

csharp_style_var_when_type_is_apparent

Eigentum	Wert	Beschreibung
Name der Option	csharp_style_var_when_type_is_apparent
Optionswerte	`true`	Bevorzugen Sie `var`, wenn der Typ bereits auf der rechten Seite eines Deklarationsausdrucks erwähnt wird
	`false`	Expliziten Typ bevorzugen, wenn der Typ bereits auf der rechten Seite eines Deklarationsausdrucks erwähnt wird
Standard-Optionswert	`false`

// csharp_style_var_when_type_is_apparent = true
var obj = new Customer();

// csharp_style_var_when_type_is_apparent = false
Customer obj = new Customer();

csharp_style_var_elsewhere

Eigentum	Wert	Beschreibung
Name der Option	csharp_style_var_elsewhere
Optionswerte	`true`	`var` in allen Fällen gegenüber dem expliziten Typ bevorzugen, außer bei einer Überschreibung durch eine andere Codeformatregel.
	`false`	Den expliziten Typ in allen Fällen gegenüber `var` bevorzugen, außer bei einer Überschreibung durch eine andere Codeformatregel.
Standardoptionenwert	`false`

// csharp_style_var_elsewhere = true
var f = this.Init();

// csharp_style_var_elsewhere = false
bool f = this.Init();

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 IDE0007 // Or IDE0008
// The code that's violating the rule is on this line.
#pragma warning restore IDE0007 // Or IDE0008

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

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

Um alle Regeln im Code-Stil zu deaktivieren, setzen Sie den Schweregrad für die Kategorie in der KonfigurationsdateiStyle auf none.

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

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

Freigeben über