Preferencje "var" (IDE0007 i IDE0008)

Artykuł
04/07/2023

W tym artykule opisano dwie powiązane reguły i IDE0007IDE0008.

Właściwość	Wartość
Identyfikator zasady	IDE0007
Tytuł	Użyj `var` zamiast jawnego typu
Kategoria	Styl
Subcategory (Podkategoria)	Reguły języka (preferencje var)
Odpowiednie języki	C#
Opcje	`csharp_style_var_for_built_in_types`
	`csharp_style_var_when_type_is_apparent`
	`csharp_style_var_elsewhere`

Właściwość	Wartość
Identyfikator zasady	IDE0008
Tytuł	Użyj jawnego typu zamiast `var`
Kategoria	Styl
Subcategory (Podkategoria)	Reguły języka (preferencje var)
Odpowiednie języki	C#
Opcje	`csharp_style_var_for_built_in_types`
	`csharp_style_var_when_type_is_apparent`
	`csharp_style_var_elsewhere`

Omówienie

Te dwie reguły stylu określają, czy słowo kluczowe var , czy jawny typ powinien być używany w deklaracji zmiennej. Aby wymusić to var ustawienie, ustaw ważność IDE0007 ostrzeżenia lub błędu. Aby wymusić, że używany jest jawny typ, ustaw ważność IDE0008 ostrzeżenia lub błędu.

Opcje

Skojarzone opcje tej reguły definiują, gdzie należy zastosować te preferencje stylu:

Typy wbudowane (csharp_style_var_for_built_in_types)
Miejsca, w których typ jest widoczny (csharp_style_var_when_type_is_apparent)
Gdzie indziej (csharp_style_var_elsewhere)

Aby uzyskać więcej informacji na temat konfigurowania opcji, zobacz Format opcji.

csharp_style_var_for_built_in_types

Właściwość	Wartość	Opis
Nazwa opcji	csharp_style_var_for_built_in_types
Wartości opcji	`true`	Preferuj `var` służy do deklarowania zmiennych z wbudowanymi typami systemowymi, takimi jak `int`
	`false`	Preferuj jawny typ `var` do deklarowania zmiennych z wbudowanymi typami systemowymi, takimi jak `int`
Wartość opcji domyślnej	`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

Właściwość	Wartość	Opis
Nazwa opcji	csharp_style_var_when_type_is_apparent
Wartości opcji	`true`	Preferuj `var` , gdy typ jest już wymieniony po prawej stronie wyrażenia deklaracji
	`false`	Preferuj jawny typ, gdy typ jest już wymieniony po prawej stronie wyrażenia deklaracji
Wartość opcji domyślnej	`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

Właściwość	Wartość	Opis
Nazwa opcji	csharp_style_var_elsewhere
Wartości opcji	`true`	Preferuj `var` jawny typ we wszystkich przypadkach, chyba że zostanie zastąpiony przez inną regułę stylu kodu
	`false`	Preferuj jawny typ `var` we wszystkich przypadkach, chyba że zostanie zastąpiony przez inną regułę stylu kodu
Wartość opcji domyślnej	`false`

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

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

Pomijanie ostrzeżenia

Jeśli chcesz pominąć tylko jedno naruszenie, dodaj dyrektywy preprocesora do pliku źródłowego, aby wyłączyć, a następnie ponownie włączyć regułę.

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

Aby wyłączyć regułę dla pliku, folderu lub projektu, ustaw jego ważność na none w pliku konfiguracji.

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

Aby wyłączyć wszystkie reguły stylu kodu, ustaw ważność dla kategorii Style na none w pliku konfiguracji.

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

Aby uzyskać więcej informacji, zobacz Jak pominąć ostrzeżenia analizy kodu.