Préférences 'var' (IDE0007 et IDE0008)

Article
02/12/2025

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

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

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

Aperçu

Ces deux règles de style définissent si le mot clé var var ou un type explicite doit être utilisé dans une déclaration de variable. Pour garantir que var soit utilisée, définissez la gravité de IDE0007 comme un avertissement ou une erreur. Pour imposer l'utilisation du type explicite, définissez la gravité de IDE0008 comme étant un avertissement ou une erreur.

Options

Les options associées à cette règle définissent l’emplacement 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 de l'option.

csharp_style_var_for_built_in_types

Propriété	Valeur	Description
nom de l’option	csharp_style_var_for_built_in_types
Valeurs d’option	`true`	Préférer `var` est utilisé pour déclarer des variables avec des types système intégrés tels que `int`
	`false`	Préférer un type explicite à `var` pour déclarer des variables avec des types système intégrés tels que `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 de l’option	csharp_style_var_when_type_is_apparent
Valeurs d'option	`true`	Préférer `var` lorsque le type est déjà mentionné sur le côté droit d’une expression de déclaration
	`false`	Préférer le type explicite lorsque le type est déjà mentionné sur le 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 de l’option	csharp_style_var_elsewhere
Valeurs d’option	`true`	Préférer `var` sur le type explicite dans tous les cas, sauf en cas de substitution par une autre règle de style de code
	`false`	Préférer le type explicite à `var` dans tous les cas, sauf si elle est remplacée par une autre règle de style de code
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 souhaitez supprimer une seule violation, ajoutez des directives de préprocesseur à votre fichier source pour désactiver, puis réactivez 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 d’un fichier, d’un dossier ou d’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 d’analyse du code.

Voir aussi

mot-clé var
règles de langage de style de code
Référence sur les règles de style de code

Partager via