Langage et règles inutiles

Les règles de langage de style code affectent la façon dont différentes constructions de langages de programmation .NET, par exemple, des modificateurs et des parenthèses, sont utilisées.

Cette catégorie inclut également des règles qui identifient les parties de la base de code qui sont inutiles et qui peuvent être refactorisées ou supprimées. La présence d’un code inutile indique un ou plusieurs des problèmes suivants :

• Lisibilité : code qui dégrade inutilement la lisibilité.
• Maintenabilité : code qui n’est plus utilisé après la refactorisation et qui est inutilement maintenu.
• Performance : un calcul inutile qui n’a aucun effet secondaire et entraîne une surcharge de performance.
• Fonctionnalité : problème fonctionnel dans le code entraînant la redondance du code requis. Par exemple, IDE0060 indique les paramètres inutilisés où la méthode ignore accidentellement un paramètre d’entrée.

Les règles de langage sont réparties dans les catégories suivantes :

• .NET règles de style : règles qui s’appliquent à la fois à C# et Visual Basic. Les noms d’options pour ces règles commencent par le préfixe dotnet_style_.
• Règles de style C# : règles spécifiques au code C#. Les noms d’options pour ces règles commencent par le préfixe csharp_style_.
• Visual Basic règles de style : règles spécifiques au code Visual Basic. Les noms d’options pour ces règles commencent par le préfixe visual_basic_style_.

Format de l’option

La plupart des règles de langage ont une ou plusieurs options associées pour personnaliser le style préféré. Par exemple, Utiliser une instruction « using » simple (IDE0063) présente l’option associée csharp_prefer_simple_using_statement qui vous permet de définir si vous préférez une déclaration using ou une instruction using. La règle applique les options que vous choisissez à un niveau spécifié, par exemple, un avertissement ou une erreur.

Les options pour les règles de langue peuvent être spécifiées dans un fichier config au format suivant :

option_name = value (Visual Studio 2019 et versions ultérieures)

ou

option_name = value:severity

• Valeur

  Pour chaque convention de langage, vous spécifiez une valeur qui définit si ou quand favoriser ce style. De nombreuses règles acceptent une valeur de true (préférer ce style) ou false (ne pas préférer ce style). D’autres règles acceptent des valeurs telles que when_on_single_line ou never.

• Severity (facultatif dans Visual Studio 2019 et versions ultérieures)

  La seconde partie de la règle spécifie le niveau de gravité pour la règle. Dans .NET 9 et versions ultérieures, la gravité est toujours respectée, c’est-à-dire dans les IDE de développement et pendant les compilations en ligne de commande. Dans .NET 8 et versions antérieures, ce paramètre de gravité n’est respecté qu’à l’intérieur des EDI de développement, tels que Visual Studio et pas lors de la compilation.

  Si vous utilisez le Kit de développement logiciel (SDK) .NET 8 ou une version antérieure et que vous souhaitez que le niveau de sévérité soit respecté au moment de la génération, vous avez deux options :

  • Définissez la propriété <AnalysisLevel> ou <AnalysisLevelStyle> à 9.0 ou plus, ou à preview.
  • Définissez la gravité en utilisant plutôt la syntaxe de configuration de gravité basée sur l’ID de règle pour les analyseurs. La syntaxe prend la forme dotnet_diagnostic.<rule ID>.severity = <severity>, par exemple, dotnet_diagnostic.IDE0040.severity = warning. Pour plus d’informations, consultez niveau de gravité.

Index de règle

Les règles de langage et de code inutiles sont classées en sous-catégories, telles que les préférences au niveau de l’expression, les préférences de bloc de code et les préférences de modificateur.

• Préférences pour la directive using
• Préférences relatives aux blocs de code
• Membres à corps d'expression
• Préférences au niveau des expressions
• Préférences de champ
• Préférences de mot clé de langage par rapport aux types d’infrastructure
• Modifier les préférences
• Préférences de nouvelle ligne
• Préférences de vérification de valeur null
• Préférences relatives aux paramètres
• Préférences relatives aux parenthèses
• Préférences de correspondance de modèle
• Préférences de suppression
• Préférences This. et me.
• Préférences var

Préférences pour la directive using

règles de style .NET (C# et Visual Basic) :

• En-tête de fichier requis (IDE0073)

Règles de style C# :

• Supprimer les directives using inutiles (IDE0005)
• Placement de la directive « using » (IDE0065)

Préférences relatives aux blocs de code

Règles de style C# :

• Ajouter des accolades (IDE0011)
• Utiliser une instruction « using » simple (IDE0063)
• Préférences de déclaration d’espace de noms (IDE0160, IDE0161)
• Supprimer l’expression lambda inutile (IDE0200)
• Convertir en instructions de niveau supérieur (IDE0210)
• Convertir en programme de style « Program.Main » (IDE0211)
• Utiliser le constructeur principal (IDE0290)
• Préférer « System.Threading.Lock » (IDE0330)

Membres au corps d'expression

Règles de style C# :

• Utiliser un corps d'expression pour les constructeurs (IDE0021)
• Utiliser un corps d'expression pour les méthodes (IDE0022)
• Utiliser le corps d’expression pour les opérateurs (IDE0023, IDE0024)
• Utiliser un corps d'expression pour les propriétés (IDE0025)
• Utiliser un corps d'expression pour les indexeurs (IDE0026)
• Utiliser un corps d'expression pour les accesseurs (IDE0027)
• Utiliser un corps d'expression pour les expressions lambda (IDE0053)
• Utiliser un corps d'expression pour des fonctions locales (IDE0061)

Préférences au niveau des expressions

règles de style .NET (C# et Visual Basic) :

• Simplifier le nom (IDE0001)
• Simplifier l’accès au membre (IDE0002)
• Supprimer un cast inutile (IDE0004)
• Ajouter des cas manquants à l’instruction switch (IDE0010)
• Utiliser des initialiseurs d’objets (IDE0017)
• Utiliser des initialiseurs de collections (IDE0028)
• La vérification de valeur nulle peut être simplifiée (IDE0029, IDE0030, IDE0270)
• Utiliser la propagation nulle (IDE0031)
• Utiliser la propriété implémentée automatiquement (IDE0032)
• Utiliser le nom de tuple fourni explicitement (IDE0033)
• Supprimer un code inaccessible (IDE0035)
• Utiliser des noms de membres déduits (IDE0037)
• Utiliser la vérification « is null » (IDE0041)
• Utiliser une expression conditionnelle pour l’affectation (IDE0045)
• Utiliser une expression conditionnelle pour le retour (IDE0046)
• Convertir un type anonyme en tuple (IDE0050)
• Supprimer un membre privé non utilisé (IDE0051)
• Supprimer un membre privé non lu (IDE0052)
• Utiliser l’affectation composée (IDE0054, IDE0074)
• Supprimer la valeur d’expression inutile (IDE0058)
• Supprimer une affectation de valeur inutile (IDE0059)
• Utiliser « System.HashCode.Combine » (IDE0070)
• Simplifier l’interpolation (IDE0071)
• Simplifier l’expression conditionnelle (IDE0075)
• Convertir typeof en nameof (IDE0082)
• Supprimer l’opérateur d’égalité inutile (IDE0100)
• Simplifier une expression LINQ (IDE0120)
• Simplifier le contrôle de type et la conversion LINQ (IDE0121)
• L’espace de noms ne correspond pas à la structure des dossiers (IDE0130)

Règles de style C# :

• Utiliser l’expression throw (IDE0016)
• Déclaration inline de variable (IDE0018)
• Simplifier l'expression « par défaut » (IDE0034)
• Utiliser une fonction locale au lieu d’une fonction lambda (IDE0039)
• Déconstruire la déclaration de variables (IDE0042)
• Utiliser un opérateur d’index (IDE0056)
• Utiliser un opérateur de plages (IDE0057)
• Ajouter des cas manquants à l’expression switch (IDE0072)
• Supprimer l’opérateur de suppression inutile (IDE0080)
• Simplifier l’expression new (IDE0090)
• Supprimer tout discard inutile (IDE0110)
• Préférer la vérification « null » à la vérification de type (IDE0150)
• Utiliser un tuple pour échanger des valeurs (IDE0180)
• Ajouter un cast explicite dans la boucle foreach (IDE0220)
• Ajouter un cast explicite (IDE0221)
• Utiliser une chaîne littérale en UTF-8 (IDE0230)
• La directive Nullable est redondante (IDE0240)
• La directive Nullable est inutile (IDE0241)
• Utiliser l’expression de collection pour le tableau (IDE0300)
• Utiliser une expression de collection pour un ensemble vide (IDE0301)
• Utiliser l’expression de collection pour l’alloc de pile (IDE0302)
• Utiliser l’expression de collection pour Create() (IDE0303)
• Utiliser l’expression de collection pour le générateur (IDE0304)
• Utiliser l’expression de collection pour fluent (IDE0305)
• Utiliser l’expression de collection pour le nouveau (IDE0306)
• Utiliser un type générique indépendant (IDE0340)
• Utiliser une expression lambda implicitement typée (IDE0350)
• Simplifier l’accesseur de propriété (IDE0360)

règles de style Visual Basic :

• Supprimer ByVal (IDE0081)
• Utiliser la correspondance de modèles (opérateur IsNot) (IDE0084)
• Simplifier la création d’objets (IDE0140)

Préférences de champ

règles de style .NET (C# et Visual Basic) :

• Ajouter un modificateur en lecture seule (IDE0044)

Préférences de mot clé de langage par rapport aux types d’infrastructure

règles de style .NET (C# et Visual Basic) :

• Utiliser des mots clés de langage au lieu de noms de type de framework pour les références de type (IDE0049)

Préférences relatives aux modificateurs

règles de style .NET (C# et Visual Basic) :

• Modificateurs d’ordre (IDE0036)
• Ajouter des modificateurs d’accessibilité (IDE0040)

Règles de style C# :

• Rendre la fonction locale statique (IDE0062)
• Rendre les champs de struct accessibles en écriture (IDE0064)
• Un struct peut être déclaré 'readonly' (IDE0250)
• Le membre peut être défini en 'readonly' (IDE0251)
• Rendre la fonction anonyme statique (IDE0320)
• Supprimer un modificateur inutile unsafe (IDE0380)

Préférences de nouvelle ligne

règles de style .NET (C# et Visual Basic) :

• Évitez plusieurs lignes vides (IDE2000)†
• Ligne vide requise entre l’instruction block et l’instruction suivante (IDE2003)†

Règles de style C# :

• Les instructions incorporées doivent être sur leur propre ligne (IDE2001)†
• Les crochets consécutifs ne doivent pas avoir de ligne vide entre eux (IDE2002)†
• Ligne vide interdite après le signe deux-points de l'initialiseur de constructeur (IDE2004)†
• Ligne vide non autorisée après le jeton d’expression conditionnelle (IDE2005)†
• Ligne vide non autorisée après le jeton de clause d’expression de flèche (IDE2006)†

†Les règles sont expérimentales et sujettes à modification ou suppression.

Préférences de vérification de valeur nulle

Règles de style C# :

• Utiliser un appel délégué conditionnel (IDE1005)

Préférences relatives aux paramètres

règles de style .NET (C# et Visual Basic) :

• Supprimer un paramètre inutilisé (IDE0060)
• Utilisez 'nameof' (IDE0280)

Préférences relatives aux parenthèses

règles de style .NET (C# et Visual Basic) :

• Préférences de parenthèses (IDE0047, IDE0048)

Préférences de correspondance de modèle

Règles de style C# :

• Utiliser la correspondance de modèle pour éviter « as » suivi d’une vérification « nulle » (IDE0019)
• Utiliser la correspondance de modèle pour éviter la vérification « is » suivie d’un cast (IDE0020, IDE0038)
• Utiliser l'expression switch (IDE0066)
• Utiliser la correspondance de modèles (IDE0078 et IDE0260)
• Utiliser la correspondance de motifs (opérateur not) (IDE0083)
• Simplifier le modèle de propriété (IDE0170)

Préférences de suppression

règles de style .NET (C# et Visual Basic) :

• Élimination de la suppression inutile (IDE0079)

Règles de style C# :

• Supprimer la suppression inutile (opérateur null-forgiving) (IDE0370)

Préférences This. et me.

règles de style .NET (C# et Visual Basic) :

• Préférences de qualification d’accès aux membres (IDE0003 et IDE0009)

Préférences var

Règles de style C# :

• Préférences « var » (IDE0007, IDE0008)

Voir aussi

• informations de référence sur les règles de style de code .NET