Règles de langage

Les règles de langage de style de code affectent la manière dont les différentes constructions de langages de programmation .NET, par exemple les modificateurs et les parenthèses, sont utilisées. Les règles sont classées dans les catégories suivantes :

  • Règles de style .net: règles qui s’appliquent à la fois à C# et Visual Basic. Les noms des options EditorConfig pour ces règles commencent par le dotnet_style_ préfixe.
  • Règles de style c#: règles spécifiques au langage c# uniquement. Les noms des options EditorConfig pour ces règles commencent par le csharp_style_ préfixe.
  • Règles de style de Visual Basic: règles spécifiques à Visual BSIC Language uniquement. Les noms des options EditorConfig pour ces règles commencent par le visual_basic_style_ préfixe.

Format d’option

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

option_name = value (Visual Studio 2019 version 16,9 Preview 2 et versions ultérieures)

ou

option_name = value:severity

  • Valeur

    Pour chaque règle de langue, vous spécifiez une valeur qui définit si le style doit être préféré ou pas. De nombreuses règles acceptent la valeur 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 .

  • Gravité (facultatif dans Visual Studio 2019 version 16,9 Preview 2 et versions ultérieures)

    La deuxième partie de la règle spécifie le niveau de gravité de la règle. Lorsqu’il est spécifié de cette manière, le paramètre de gravité est respecté uniquement dans les IDE de développement, tels que Visual Studio. Elle n’est pas respectée lors de la génération.

    Pour appliquer des règles de style de code au moment de la génération, définissez la gravité en utilisant la syntaxe de configuration de gravité basée sur l’ID de règle pour les analyseurs à la place. La syntaxe prend la forme dotnet_diagnostic.<rule ID>.severity = <severity> , par exemple, dotnet_diagnostic.IDE0040.severity = silent . Pour plus d’informations, consultez niveau de gravité.

Conseil

À compter de Visual Studio 2019 version 16,3, vous pouvez configurer des règles de style de code à partir du menu de l’ampoule actions rapides après une violation de style. Pour plus d’informations, consultez configurer automatiquement les styles de code dans Visual Studio.

Règles de style .NET

Les règles de style mentionnées dans cette section s’appliquent aussi bien au langage C# qu’au langage Visual Basic.

Règles de style C#

Les règles de style de cette section s’appliquent uniquement au langage C#.

Règles de style de Visual Basic

Les règles de style de cette section s’appliquent uniquement à Visual Basic langage.

Voir aussi