Supprimer la valeur d’expression inutile (IDE0058)

Propriété	Value
Identificateur de la règle	IDE0058
Titre	Supprimer la valeur d’expression inutile
Catégorie	Style
Sous-catégorie	Règles de langage (préférences au niveau de l’expression)
Langages applicables	C# et Visual Basic
Options	csharp_style_unused_value_expression_statement_preference
	visual_basic_style_unused_value_expression_statement_preference

Vue d’ensemble

Cette règle signale les valeurs d’expression inutilisées. Par exemple :

void M()
{
  Compute(); // IDE0058: computed value is never used.
}

int Compute();

Vous pouvez effectuer l’une des actions suivantes pour corriger cette violation :

• Si l’expression n’a aucun effet secondaire, supprimez l’instruction entière. Cela améliore les performances en évitant les calculs inutiles.

• Si l’expression a des effets secondaires, remplacez le côté gauche de l’attribution par un discard (C# uniquement) ou une variable locale qui n’est jamais utilisée. Cela améliore la clarté du code en montrant explicitement l’intention d’abandonner une valeur inutilisée.

  _ = Compute();
  

Options

Les options de cette règle spécifient s’il faut préférer l’utilisation d’un discard ou d’une variable locale inutilisée :

• C# – csharp_style_unused_value_expression_statement_preference
• Visual Basic – visual_basic_style_unused_value_expression_statement_preference

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

csharp_style_unused_value_expression_statement_preference

Propriété	Valeur	Description
Nom d'option	csharp_style_unused_value_expression_statement_preference
Langages applicables	C#
Valeurs d’option	discard_variable	Préférer l’assignation d’une expression inutilisée à un discard
	unused_local_variable	Préférer l’assignation d’une expression inutilisée à une variable locale jamais utilisée
Valeur d’option par défaut	discard_variable

// Original code:
System.Convert.ToInt32("35");

// After code fix for IDE0058:

// csharp_style_unused_value_expression_statement_preference = discard_variable
_ = System.Convert.ToInt32("35");

// csharp_style_unused_value_expression_statement_preference = unused_local_variable
var unused = Convert.ToInt32("35");

visual_basic_style_unused_value_expression_statement_preference

Propriété	Valeur	Description
Nom d'option	visual_basic_style_unused_value_expression_statement_preference
Langages applicables	Visual Basic
Valeurs d’option	unused_local_variable	Préférer l’assignation d’une expression inutilisée à une variable locale jamais utilisée
Valeur d’option par défaut	unused_local_variable

' visual_basic_style_unused_value_expression_statement_preference = unused_local_variable
Dim unused = Computation()

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 IDE0058
// The code that's violating the rule is on this line.
#pragma warning restore IDE0058

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.IDE0058.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

• Supprimer l’attribution de valeur inutile (IDE0059)
• Référence sur les règles de style de code