Udostępnij za pośrednictwem


Preferencje "var" (IDE0007 i IDE0008)

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:

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.

Zobacz też