Preferencje "var" (IDE0007 i IDE0008)

Artykuł
02/08/2025

W tym artykule opisano dwie powiązane reguły, IDE0007 i IDE0008.

Własność	Wartość
identyfikator reguły	IDE0007
Tytuł	Użyj `var` zamiast jawnego typu
Kategoria	Styl
podkategorii	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łasność	Wartość
identyfikator reguły	IDE0008
Tytuł	Użyj jawnego typu zamiast `var`
Kategoria	Styl
podkategorii	Reguły Języka ('var' preferencje)
Języki do zastosowania	C#
opcje	`csharp_style_var_for_built_in_types`
	`csharp_style_var_when_type_is_apparent`
	`csharp_style_var_elsewhere`

Przegląd

Te dwie reguły stylu określają, czy słowo kluczowe var czy jawny typ powinien być używany w deklaracji zmiennej. Aby wymusić użycie var, ustaw stopień IDE0007 na ostrzeżenie lub błąd. Aby wymusić używanie jawnego typu, ustaw stopień ważności IDE0008 na ostrzeżenie lub błąd.

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_dla_typów_wbudowanych

Własność	Wartość	Opis
nazwa opcji	Specjalny styl CSharp dla 'var' w typach wbudowanych - csharp_style_var_for_built_in_types
wartości opcji	`true`	Zaleca się używanie `var` do deklarowania zmiennych z wbudowanymi typami systemowymi, takimi jak `int`
	`false`	Preferuj jawny typ `var`, aby zadeklarować zmienne z wbudowanymi typami systemowymi, takimi jak `int`
domyślna wartość opcji	`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łasność	Wartość	Opis
nazwa opcji	csharp_style_var_when_type_is_apparent (styl var, gdy typ jest oczywisty)
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
domyślna wartość opcji	`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łasność	Wartość	Opis
nazwa opcji	csharp_style_var_elsewhere
wartości opcji	`true`	Preferuj `var` nad jawny typ we wszystkich przypadkach, chyba że zastąpi to inna reguła stylu kodu
	`false`	Preferuj jawny typ `var` we wszystkich przypadkach, chyba że zostanie zastąpiona przez inną regułę stylu kodu
domyślna wartość opcji	`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 poziom istotności dla kategorii Style na wartość 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.

Udostępnij za pośrednictwem