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 :

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