Předvolby var (IDE0007 a IDE0008)

Článek
06/08/2023

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

Vlastnost	Hodnota
ID pravidla	IDE0007
Název	Použití `var` místo explicitního typu
Kategorie	Styl
Subcategory	Pravidla jazyka (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 explicitního typu `var`
Kategorie	Styl
Subcategory	Pravidla jazyka (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 se má v deklaraci proměnné použít klíčové slovo var nebo explicitní typ. Pokud chcete tuto možnost vynutit var , 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

Možnosti přidružené k tomuto pravidlu definují, kde se má tato předvolba stylu použít:

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

Další informace o konfiguraci možností najdete 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`	Prefer `var` se používá k deklaraci proměnných s integrovanými typy systému, jako jsou například `int`
	`false`	Upřednostněte explicitní typ před `var` deklarací proměnných s integrovanými typy systému, jako jsou `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`	Preferovat `var` , když už je typ 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`	Ve všech případech upřednostněte `var` před explicitním typem, pokud není přepsáno jiným pravidlem stylu kódu.
	`false`	Ve všech případech upřednostněte explicitní typ před `var` , pokud ho nepřepíšete 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, aby se pravidlo zakázalo a znovu povolte.

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

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

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

Pokud chcete zakázat všechna pravidla stylu kódu, nastavte v konfiguračním souboru závažnost kategorie Style na none .

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

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