Inställningar för variabeltypen 'var' (IDE0007 och IDE0008)

Artikel
02/09/2025

Den här artikeln beskriver två relaterade regler, IDE0007 och IDE0008.

Egenskap	Värde
regel-ID	IDE0007
rubrik	Använd `var` i stället för explicit typ
Kategori	Stil
underkategori	Språkregler ("var"-inställningar)
Tillämpliga språk	C#
alternativ	`csharp_style_var_for_built_in_types`
	`csharp_style_var_when_type_is_apparent`
	`csharp_style_var_elsewhere`

Egenskap	Värde
regel-ID	IDE0008
Rubrik	Använd explicit typ i stället för `var`
Kategori	Stil
underkategori	Språkregler ("var"-inställningar)
Tillämpliga språk	C#
alternativ	`csharp_style_var_for_built_in_types`
	`csharp_style_var_when_type_is_apparent`
	`csharp_style_var_elsewhere`

Överblick

Dessa två formatregler definierar om nyckelordet var eller en explicit typ ska användas i en variabeldeklaration. Om du vill framtvinga att var används anger du allvarlighetsgraden för IDE0007 till varning eller fel. Om du vill framtvinga att den explicita typen används anger du allvarlighetsgraden för IDE0008 till varning eller fel.

Alternativ

Den här regelns associerade alternativ definierar var den här formatinställningen ska tillämpas:

Inbyggda typer (csharp_style_var_for_built_in_types)
Platser där typen är uppenbar (csharp_style_var_when_type_is_apparent)
På annat håll (csharp_style_var_elsewhere)

Mer information om hur du konfigurerar alternativ finns i Alternativformat.

csharp_stil_var_för_inbyggda_typ

Egenskap	Värde	Beskrivning
Alternativnamn	csharp_style_var_for_built_in_types
Alternativvärden	`true`	Föredra att `var` används för att deklarera variabler med inbyggda systemtyper som `int`
	`false`	Föredrar explicit typ framför `var` för att deklarera variabler med inbyggda systemtyper som `int`
standardalternativvärde	`false`

// csharp_style_var_for_built_in_types = true
var x = 5;

// csharp_style_var_for_built_in_types = false
int x = 5;

csharp_stil_var_när_typen_är_tydlig

Egenskap	Värde	Beskrivning
Alternativnamn	csharp_stil_var_när_typen_är_synlig
Alternativvärden	`true`	Föredrar `var` när typen redan anges till höger i ett deklarationsuttryck
	`false`	Föredrar explicit typ när typen redan nämns till höger i ett deklarationsuttryck
standardalternativvärde	`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

Egenskap	Värde	Beskrivning
Alternativnamn	csharp_style_var_elsewhere
Alternativvärden	`true`	Föredra `var` framför explicit typ i alla fall, såvida den inte åsidosätts av en annan kodstilsregel
	`false`	Föredrar explicit typ framför `var` i alla fall, såvida den inte åsidosätts av en annan regel för kodformat
standardalternativvärde	`false`

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

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

Undertryck en varning

Om du bara vill förhindra en enda överträdelse lägger du till förprocessordirektiv i källfilen för att inaktivera och återaktiverar sedan regeln.

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

Om du vill inaktivera regeln för en fil, mapp eller ett projekt anger du dess allvarlighetsgrad till none i konfigurationsfilen.

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

Om du vill inaktivera alla regler i kodformat anger du allvarlighetsgraden för kategorin Style till none i konfigurationsfilen .

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

Mer information finns i Så här utelämnar du kodanalysvarningar.

Dela via