'var' voorkeuren (IDE0007 en IDE0008)

Artikel
02/08/2025

In dit artikel worden twee gerelateerde regels beschreven, IDE0007 en IDE0008.

Eigendom	Waarde
Regel ID	IDE0007
titel	Gebruik `var` in plaats van expliciet type
Categorie	Stijl
subcategorie	Taalregels ('var' voorkeuren)
Toepasselijke talen	C#
opties	`csharp_style_var_for_built_in_types`
	`csharp_style_var_when_type_is_apparent`
	`csharp_style_var_elsewhere`

Eigenschap	Waarde
regel-ID	IDE0008
titel	Gebruik expliciet type in plaats van `var`
Categorie	Stijl
Subcategorie	Taalregels ('var' voorkeuren)
Toepasselijke talen	C#
opties	`csharp_style_var_for_built_in_types`
	`csharp_style_var_when_type_is_apparent`
	`csharp_style_var_elsewhere`

Overzicht

Deze twee stijlregels bepalen of het var trefwoord of een expliciet type moet worden gebruikt in een variabeledeclaratie. Als u wilt afdwingen dat var wordt gebruikt, stelt u de ernst van IDE0007 in op waarschuwing of fout. Als u wilt afdwingen dat het expliciete type wordt gebruikt, stelt u de ernst van IDE0008 in op waarschuwing of fout.

Opties

Met de gekoppelde opties van deze regel wordt gedefinieerd waar deze stijlvoorkeur moet worden toegepast:

Ingebouwde typen (csharp_style_var_for_built_in_types)
Plaatsen waar het type duidelijk is (csharp_style_var_when_type_is_apparent)
Elders (csharp_style_var_elsewhere)

Zie Option-indelingvoor meer informatie over het configureren van opties.

csharp_style_var_for_built_in_types

Eigendom	Waarde	Beschrijving
Optienaam	csharp_style_var_for_built_in_types
optiewaarden	`true`	Geef de voorkeur aan `var` wordt gebruikt om variabelen te declareren met ingebouwde systeemtypen zoals `int`
	`false`	Geef de voorkeur aan expliciet type boven `var` om variabelen te declareren met ingebouwde systeemtypen zoals `int`
standaardoptiewaarde	`false`

// csharp_style_var_for_built_in_types = true
var x = 5;

// csharp_style_var_for_built_in_types = false
int x = 5;

stijl_var_csharp_wanneer_type_duidelijk_is

Eigenschap	Waarde	Beschrijving
optienaam	csharp_style_var_when_type_is_apparent
Optiewaarden	`true`	Geef de voorkeur aan `var` wanneer het type al aan de rechterkant van een declaratie-expressie wordt vermeld
	`false`	Geef de voorkeur aan expliciet type wanneer het type al wordt vermeld aan de rechterkant van een declaratie-expressie
standaardoptiewaarde	`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

Eigenschap	Waarde	Beschrijving
optienaam	csharp_style_var_elsewhere
optiewaarden	`true`	Geef de voorkeur aan `var` boven een expliciet type in alle gevallen, tenzij het wordt overschreven door een andere codestijlregel.
	`false`	Geef in alle gevallen de voorkeur aan expliciet type boven `var`, tenzij deze wordt overschreven door een andere codestijlregel
standaardoptiewaarde	`false`

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

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

Een waarschuwing onderdrukken

Als u slechts één schending wilt onderdrukken, voegt u preprocessorrichtlijnen toe aan uw bronbestand om de regel uit te schakelen en vervolgens opnieuw in te schakelen.

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

Als u de regel voor een bestand, map of project wilt uitschakelen, stelt u de ernst ervan in op none in het configuratiebestand.

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

Als u alle regels voor de codestijl wilt uitschakelen, stelt u de ernst voor de categorie Style in op none in het configuratiebestand.

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

Voor meer informatie, zie Hoe codeanalysewaarschuwingen te onderdrukken.

Delen via