Předvolby var (IDE0007 a IDE0008)

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