Preferenze 'var' (IDE0007 e IDE0008)

Articolo
06/08/2023

Questo articolo descrive due regole IDE0007 correlate e IDE0008.

Proprietà	Valore
ID regola	IDE0007
Titolo	Usare `var` invece di tipo esplicito
Categoria	Stile
Subcategory	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	Usare il tipo esplicito anziché `var`
Categoria	Stile
Subcategory	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 o un tipo esplicito deve essere usata in una dichiarazione di variabile. Per applicare tale var operazione, impostare la gravità di IDE0007 su avviso o errore. Per applicare che il tipo esplicito venga usato, impostare la gravità di IDE0008 su avviso o errore.

Opzioni

Le opzioni associate a questa regola definiscono la posizione in cui deve essere applicata 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_for_built_in_types

Proprietà	Valore	Descrizione
Nome opzione	csharp_style_var_for_built_in_types
Valori di opzione	`true`	La preferenza `var` viene usata per dichiarare le variabili con tipi di sistema predefiniti, ad esempio `int`
	`false`	Preferire il tipo esplicito per `var` dichiarare le variabili con tipi di sistema predefiniti, ad esempio `int`
Valore dell'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;

csharp_style_var_when_type_is_apparent

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`	Preferire il tipo esplicito quando il tipo è già menzionato sul lato destro di un'espressione di dichiarazione
Valore dell'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 di opzione	`true`	Preferire `var` il tipo esplicito in tutti i casi, a meno che non venga eseguito l'override da un'altra regola di stile del codice
	`false`	Preferire il tipo `var` esplicito in tutti i casi, a meno che non venga eseguito l'override da un'altra regola di stile del codice
Valore dell'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 vuole eliminare solo una singola violazione, aggiungere direttive di 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, impostare la relativa gravità su none nel file di configurazione.

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

Per disabilitare tutte le regole in stile 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.