Préférences « var » (IDE0007 et IDE0008)

Article
06/21/2023

Cet article décrit deux règles associées, IDE0007 et IDE0008.

Propriété	Value
Identificateur de la règle	IDE0007
Titre	Utiliser `var` au lieu d’un type explicite
Catégorie	Style
Sous-catégorie	Règles de langage (préférences « var »)
Langages applicables	C#
Options	`csharp_style_var_for_built_in_types`
	`csharp_style_var_when_type_is_apparent`
	`csharp_style_var_elsewhere`

Propriété	Value
Identificateur de la règle	IDE0008
Titre	Utiliser un type explicite au lieu de `var`
Catégorie	Style
Sous-catégorie	Règles de langage (préférences « var »)
Langages applicables	C#
Options	`csharp_style_var_for_built_in_types`
	`csharp_style_var_when_type_is_apparent`
	`csharp_style_var_elsewhere`

Vue d’ensemble

Ces deux règles de style définissent s’il faut utiliser le mot clé var ou un type explicite dans une déclaration de variable. Pour appliquer l’utilisation de var, définissez la gravité de IDE0007 sur un avertissement ou une erreur. Pour appliquer l’utilisation du type explicite, définissez la gravité de IDE0008 sur un avertissement ou une erreur.

Options

Les options associées de cette règle définissent où cette préférence de style doit être appliquée :

Types intégrés (csharp_style_var_for_built_in_types)
Emplacements où le type est apparent (csharp_style_var_when_type_is_apparent)
Ailleurs (csharp_style_var_elsewhere)

Pour plus d’informations sur la configuration des options, consultez Format d’option.

csharp_style_var_for_built_in_types

Propriété	Valeur	Description
Nom d'option	csharp_style_var_for_built_in_types
Valeurs d’option	`true`	Préférer utiliser `var` pour déclarer des variables avec des types système intégrés comme `int`
	`false`	Préférer utiliser un type explicite au lieu `var` pour déclarer des variables avec des types système intégrés comme `int`
Valeur d’option par défaut	`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

Propriété	Valeur	Description
Nom d'option	csharp_style_var_when_type_is_apparent
Valeurs d’option	`true`	Préférer `var` quand le type est déjà mentionné du côté droit d’une expression de déclaration
	`false`	Préférer un type explicite quand le type est déjà mentionné du côté droit d’une expression de déclaration
Valeur d’option par défaut	`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

Propriété	Valeur	Description
Nom d'option	csharp_style_var_elsewhere
Valeurs d’option	`true`	Préférer `var` au lieu d’un type explicite dans tous les cas, sauf si une autre règle de style de code le remplace
	`false`	Préférer un type explicite au lieu de `var` dans tous les cas, sauf si une autre règle de style de code le remplace
Valeur d’option par défaut	`false`

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

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

Supprimer un avertissement

Si vous voulez supprimer une seule violation, ajoutez des directives de préprocesseur à votre fichier source pour désactiver et réactiver la règle.

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

Pour désactiver la règle sur un fichier, un dossier ou un projet, définissez sa gravité sur none dans le fichier de configuration.

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

Pour désactiver toutes les règles de style de code, définissez la gravité de la catégorie Style sur none dans le fichier de configuration.

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

Pour plus d’informations, consultez Comment supprimer les avertissements de l’analyse de code.