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:
- 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.
