Předvolby var (IDE0007 a IDE0008)

Článek
02/09/2025

Tento článek popisuje dvě související pravidla, IDE0007 a IDE0008.

Vlastnost	Hodnota
Identifikátor pravidla	IDE0007
název	Místo explicitního typu použijte `var`.
kategorie	Styl
podkategorie	Jazyková pravidla (předvolby "var")
příslušné jazyky	C#
Možnosti	`csharp_style_var_for_built_in_types`
	`csharp_style_var_when_type_is_apparent`
	`csharp_style_var_elsewhere`

Vlastnost	Hodnota
ID pravidla	IDE0008
název	Místo `var` použijte explicitní typ.
kategorie	Styl
podkategorie	Jazyková pravidla (předvolby 'var')
příslušné jazyky	C#
Možnosti	`csharp_style_var_for_built_in_types`
	`csharp_style_var_when_type_is_apparent`
	`csharp_style_var_elsewhere`

Přehled

Tato dvě pravidla stylu definují, zda var klíčové slovo nebo explicitní typ by se měl použít v deklaraci proměnné. Pokud chcete tuto var vynutit, nastavte závažnost IDE0007 na upozornění nebo chybu. Pokud chcete vynutit použití explicitního typu, nastavte závažnost IDE0008 na upozornění nebo chybu.

Možnosti

Přidružené možnosti tohoto pravidla definují, kde se má použít tato předvolba stylu:

Předdefinované typy (csharp_style_var_for_built_in_types)
Místa, kde je typ zjevný (csharp_style_var_when_type_is_apparent)
Jinde (csharp_style_var_elsewhere)

Další informace o konfiguraci možností naleznete v tématu Formát možnosti.

csharp_style_var_for_built_in_types

Vlastnost	Hodnota	Popis
název možnosti	csharp_style_var_for_built_in_types
hodnoty možností	`true`	Preferováno je, že `var` se používá k deklaraci proměnných s vestavěnými systémovými typy, jako je `int`
	`false`	Preferujte explicitní typ před `var` k deklaraci proměnných pomocí předdefinovaných systémových typů, jako je `int`
výchozí hodnota možnosti	`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

Vlastnost	Hodnota	Popis
název možnosti	csharp_style_var_when_type_is_apparent
hodnoty možností	`true`	Preferujte `var`, pokud je typ již uveden na pravé straně výrazu deklarace.
	`false`	Preferujte explicitní typ, pokud je typ již uveden na pravé straně výrazu deklarace
výchozí hodnota možnosti	`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

Vlastnost	Hodnota	Popis
název možnosti	csharp_style_var_elsewhere
hodnoty možností	`true`	Upřednostněte `var` před explicitním typem ve všech případech, pokud není přepsáno jiným pravidlem stylu kódu.
	`false`	Upřednostněte explicitní typ před `var` ve všech případech, pokud není přepsáno jiným pravidlem stylu kódu.
výchozí hodnota možnosti	`false`

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

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

Potlačení upozornění

Pokud chcete potlačit pouze jedno porušení, přidejte do zdrojového souboru direktivy preprocesoru, abyste pravidlo zakázali a znovu povolili.

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

Chcete-li pravidlo pro soubor, složku nebo projekt zakázat, nastavte jeho závažnost na none v konfiguračním souboru .

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

Chcete-li zakázat všechna pravidla stylu kódu, nastavte závažnost pro kategorii Style na none v konfiguračním souboru .

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

Další informace naleznete v tématu Jak potlačit upozornění analýzy kódu.

Viz také

klíčové slovo var
Pravidla stylu kódování
Odkaz na pravidla stylu kódu

Sdílet prostřednictvím