Preferenze 'var' (IDE0007 e IDE0008)

Articolo
02/08/2025

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.

Condividi tramite