'var'-voorkeuren (IDE0007 en IDE0008)

Artikel
06/08/2023

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

Eigenschap	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	Expliciet type gebruiken 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 trefwoord var 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

De gekoppelde opties van deze regel bepalen 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 Optie-indeling voor meer informatie over het configureren van opties.

csharp_style_var_for_built_in_types

Eigenschap	Waarde	Beschrijving
Naam van optie	csharp_style_var_for_built_in_types
Optiewaarden	`true`	Prefer `var` wordt gebruikt voor het declareren van variabelen met ingebouwde systeemtypen, zoals `int`
	`false`	Geef de voorkeur aan expliciet type boven `var` het declareren van variabelen met ingebouwde systeemtypen, zoals `int`
Waarde van standaardoptie	`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

Eigenschap	Waarde	Beschrijving
Naam van optie	csharp_style_var_when_type_is_apparent
Optiewaarden	`true`	Geef de voorkeur `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 aan de rechterkant van een declaratie-expressie wordt vermeld
Waarde van standaardoptie	`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
Naam van optie	csharp_style_var_elsewhere
Optiewaarden	`true`	Geef in alle gevallen de voorkeur boven `var` expliciet type, tenzij deze wordt overschreven door een andere codestijlregel
	`false`	Geef in alle gevallen de voorkeur aan expliciet type `var` , tenzij deze wordt overschreven door een andere codestijlregel
Waarde van standaardoptie	`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 preprocessor-instructies 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 in op none in het configuratiebestand.

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

Als u alle codestijlregels 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

Zie Waarschuwingen voor codeanalyse onderdrukken voor meer informatie.

Delen via