Préférences de style de codeCode style preferences

Vous pouvez définir les préférences de style de code pour vos projets C# et Visual Basic dans la boîte de dialogue Options accessible à partir du menu Outils.Code style preferences can be set for your C# and Visual Basic projects by opening the Options dialog box from the Tools menu. Dans la boîte de dialogue Options, sélectionnez Éditeur de texte > [C# ou De base] > Style de code > Général.In the Options dialog box, select Text Editor > [C# or Basic] > Code Style > General. Les options définies dans cette fenêtre s’appliquent uniquement à la machine locale.Options set in this window are applicable to the local machine only.

Chaque élément de la liste affiche un aperçu de la préférence sélectionnée :Each item in the list shows a preview of the preference when selected:

Options de style de code

Préférence et gravitéPreference and severity

Pour chaque élément, vous pouvez définir les valeurs Préférence et Gravité en utilisant les listes déroulantes sur chaque ligne.For each item, you can set the Preference and Severity values using the drop-downs on each line. L’option Gravité peut avoir la valeur Aucune, Suggestion, Avertissement ou Erreur.Severity can be set to None, Suggestion, Warning, or Error. Si vous souhaitez activer les actions rapides pour un style de code, assurez-vous que la valeur de l’option Gravité n’est pas Aucune.If you want to enable Quick Actions for a code style, ensure that the Severity setting is set to something other than None. L’icône en forme d’ampoule Actions rapides Petite icône en forme d’ampoule s’affiche quand un style qui n’est pas un style par défaut est utilisé. Vous pouvez choisir une option dans la liste Actions rapides pour réécrire automatiquement le code avec le style par défaut.The Quick Actions light bulb icon Small light bulb icon appears when a non-preferred style is used, and you can choose an option on the Quick Actions list to automatically rewrite code to the preferred style.

Fichiers EditorConfigEditorConfig files

Les paramètres de style de code pour .NET peuvent également être gérés avec un fichier EditorConfig.Code style settings for .NET can also be managed with an EditorConfig file. Les paramètres du fichier EditorConfig sont prioritaires sur les options sélectionnées dans la boîte de dialogue Options.Settings in the EditorConfig file take precedence over options selected in the Options dialog box. Vous pouvez utiliser le fichier EditorConfig pour appliquer et configurer le style de codage pour l’intégralité de votre référentiel ou projet.You can use an EditorConfig file to enforce and configure the coding style for your entire repo or project.

Commande Mettre le document en formeFormat Document command

Dans Visual Studio 2017 version 15.8 et les versions ultérieures, vous pouvez configurer la commande Mettre le document en forme (Edition > Avancé > Mettre le document en forme) pour effectuer un nettoyage de code supplémentaire sur un fichier, par exemple supprimer et trier les using ou appliquer des préférences de style de code.In Visual Studio 2017 version 15.8 and later, you can configure the Format Document command (Edit > Advanced > Format Document) to perform additional code cleanup on a file, such as remove and sort usings or apply code-style preferences. Vous pouvez définir les paramètres que la commande Mettre le document en forme doit appliquer dans la page Options de mise en forme.You can define which settings you want Format Document to apply on the Formatting options page.

Le nettoyage du code respecte les paramètres configurés dans un fichier .editorconfig ou, en l’absence de la règle ou du fichier approprié, ceux définis dans Outils > Options > Éditeur de texte > C# > [Style de code ou Mise en forme].Code cleanup respects settings configured in an .editorconfig file, or lacking that rule or file, those set in Tools > Options > Text Editor > C# > [Code Style or Formatting].

La première fois que vous déclenchez la commande Mettre le document en forme dans Visual Studio 2017, une barre d’informations jaune vous invite à configurer vos paramètres de nettoyage du code.The first time you trigger the Format Document command in Visual Studio 2017, a yellow info bar prompts you to configure your code cleanup settings.

Tip

Les règles configurées avec la valeur none dans un fichier .editorconfig ne participent pas au nettoyage du code. Toutefois, elles peuvent être appliquées individuellement via le menu Actions rapides et refactorisations.Rules configured as none in an .editorconfig file don't participate in code cleanup, but can be individually applied via the Quick Actions and Refactorings menu.

Voir aussiSee also