Partage via


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

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 :

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.

Voir aussi