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

Artikel
04/07/2023

Den här artikeln beskriver två relaterade regler och IDE0007IDE0008.

Egenskap	Värde
Regel-ID	IDE0007
Rubrik	Använd `var` i stället för explicit typ
Kategori	Format
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	Format
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`

Översikt

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

Alternativ

Den här regelns associerade alternativ definierar var den här stilinstä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)
Annan plats (csharp_style_var_elsewhere)

Mer information om hur du konfigurerar alternativ finns i Alternativformat.

csharp_style_var_for_built_in_types

Egenskap	Värde	Beskrivning
Alternativnamn	csharp_style_var_for_built_in_types
Alternativvärden	`true`	Prefer `var` används för att deklarera variabler med inbyggda systemtyper, till exempel `int`
	`false`	Föredra explicit typ framför `var` att deklarera variabler med inbyggda systemtyper, till exempel `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_style_var_when_type_is_apparent

Egenskap	Värde	Beskrivning
Alternativnamn	csharp_style_var_when_type_is_apparent
Alternativvärden	`true`	Föredra `var` när typen redan nämns 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, om du inte åsidosätts av en annan regel för kodformat
	`false`	Föredra explicit typ framför `var` i alla fall, om du 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();

Ignorera en varning

Om du bara vill förhindra en enda överträdelse lägger du till preprocessor-direktiv 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