Preferenze 'var' (IDE0007 e IDE0008)

Questo articolo descrive due regole correlate, IDE0007 e IDE0008.

Proprietà	Valore
ID regola	IDE0007
Titolo	Usare var anziché un tipo esplicitamente definito
Categoria	Stile
sottocategoria	Regole della lingua (preferenze 'var')
lingue applicabili	C#
Opzioni	csharp_style_var_for_built_in_types
	csharp_style_var_when_type_is_apparent
	csharp_style_var_elsewhere

Proprietà	Valore
ID regola	IDE0008
Titolo	Utilizzare un tipo esplicito al posto di var
categoria	Stile
sottocategoria	Regole della lingua (preferenze 'var')
lingue applicabili	C#
Opzioni	csharp_style_var_for_built_in_types
	csharp_style_var_when_type_is_apparent
	csharp_style_var_elsewhere

Panoramica

Queste due regole di stile definiscono se la parola chiave var var o un tipo esplicito deve essere usata in una dichiarazione di variabile. Per garantire che var venga utilizzato, impostare la gravità di IDE0007 su avviso o errore. Per imporre l'uso del tipo esplicito, impostare la severità di IDE0008 su messaggio di avviso o errore.

Opzioni

Le opzioni associate di questa regola definiscono la posizione in cui applicare questa preferenza di stile:

• Tipi predefiniti (csharp_style_var_for_built_in_types)
• Posizioni in cui il tipo è evidente (csharp_style_var_when_type_is_apparent)
• Altrove (csharp_style_var_elsewhere)

Per altre informazioni sulla configurazione delle opzioni, vedere Formato opzione.

csharp_style_var_per_tipi_predefiniti

Proprietà	Valore	Descrizione
nome opzione	csharp_style_var_for_built_in_types
valori di opzione	true	La preferenza var viene usata per dichiarare variabili con tipi di sistema predefiniti, ad esempio int
	false	Preferire il tipo esplicito su var per dichiarare variabili con tipi di sistema predefiniti come int
valore di opzione predefinito	false

// csharp_style_var_for_built_in_types = true
var x = 5;

// csharp_style_var_for_built_in_types = false
int x = 5;

stile_csharp_var_quando_il_tipo_è_evidente

Proprietà	Valore	Descrizione
nome opzione	csharp_style_var_when_type_is_apparent
valori di opzione	true	Preferisce var quando il tipo è già menzionato sul lato destro di un'espressione di dichiarazione
	false	Preferisce il tipo esplicito quando il tipo è già menzionato sul lato destro di un'espressione di dichiarazione
valore di opzione predefinito	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

Proprietà	Valore	Descrizione
nome opzione	csharp_style_var_elsewhere
valori delle opzioni	true	Preferire var al tipo esplicito in tutti i casi, a meno che non sia sovrascritto da un'altra regola di stile del codice.
	false	Preferire il tipo esplicito a var in tutti i casi, a meno che non venga sovrascritto da un'altra regola di stile del codice.
valore di opzione predefinito	false

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

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

Eliminare un avviso

Se si desidera eliminare solo una singola violazione, aggiungere direttive del preprocessore al file di origine per disabilitare e quindi riabilitare la regola.

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

Per disabilitare la regola per un file, una cartella o un progetto, impostarne la gravità su none nel file di configurazione .

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

Per disabilitare tutte le regole di tipo codice, impostare la gravità per la categoria Style su none nel file di configurazione .

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

Per altre informazioni, vedere Come eliminare gli avvisi di analisi del codice.

Vedere anche

• parola chiave var
• regole del linguaggio di stile del codice
• Regole di stile del codice riferimento