Options, Éditeur de texte, C#, Avancé

Utilisez la page Options avancées pour modifier les paramètres de mise en forme de l’éditeur, la refactorisation du code et les commentaires de documentation XML pour C#. Pour accéder à cette page d’options, choisissez Options d’outils>, puis choisissez Éditeur de texte>>.

Remarque

Toutes les options ne sont pas répertoriées ici.

Analyse

• Exécuter l’analyse du code en arrière-plan pour ...

  Choisissez l’une des options suivantes.

  Choix	Descriptif
  Aucun	Tous les analyseurs et correctifs de code correspondants sont désactivés. Les diagnostics du compilateur et les correctifs de code correspondants sont activés sur tous les documents ouverts .
  Document actif (valeur par défaut)	Tous les analyseurs s’exécutent uniquement sur le document actif. Les diagnostics du compilateur sont activés sur tous les documents ouverts .
  Ouvrir des documents	Tous les analyseurs et diagnostics du compilateur sont activés sur tous les documents ouverts .
  Solution entière	Tous les analyseurs et diagnostics du compilateur sont activés sur tous les documents de la solution, qu’ils soient ouverts ou fermés.

Utilisation de directives

• Placez d’abord les directives « Système » lors du tri des utilisations

  Lorsque cette option est sélectionnée, la commande Supprimer et trier les utilisations dans le menu contextuel trie les using directives et place les espaces de noms « System » en haut de la liste.

  Avant de trier :

  using AutoMapper;
  using FluentValidation;
  using System.Collections.Generic;
  using System.Linq;
  using Newtonsoft.Json;
  using System;
  

  Après le tri :

  using System;
  using System.Collections.Generic;
  using System.Linq;
  using AutoMapper;
  using FluentValidation;
  using Newtonsoft.Json;
  

• Séparer à l’aide de groupes de directives

  Lorsque cette option est sélectionnée, la commande Supprimer et trier les utilisations dans le menu contextuel sépare les using directives en insérant une ligne vide entre des groupes de directives qui ont le même espace de noms racine.

  Avant de trier :

  using AutoMapper;
  using FluentValidation;
  using System.Collections.Generic;
  using System.Linq;
  using Newtonsoft.Json;
  using System;
  

  Après le tri :

  using AutoMapper;
  
  using FluentValidation;
  
  using Newtonsoft.Json;
  
  using System;
  using System.Collections.Generic;
  using System.Linq;
  

• Suggérer des utilisations pour les types dans les assemblys .NET Framework

• Suggérer des utilisations pour les types dans les packages NuGet

  Lorsque ces options sont sélectionnées, une action rapide est disponible pour installer un package NuGet et ajouter une using directive pour les types non référencés.

  

• Ajouter des directives d’utilisation manquantes lors du collage

  Lorsque cette option est sélectionnée, using les directives sont automatiquement ajoutées à votre code lorsque vous collez un type dans un fichier.

Soulignant

• Mettre en surbrillance les références au symbole sous le curseur

  Lorsque le curseur est positionné à l’intérieur d’un symbole ou lorsque vous cliquez sur un symbole, toutes les instances de ce symbole dans le fichier de code sont mises en surbrillance.

Planification

• Entrez le mode plan lorsque les fichiers s’ouvrent

  Lorsqu’il est sélectionné, décrit automatiquement le fichier de code, qui crée des blocs réductibles de code. La première fois qu’un fichier est ouvert, #regions blocs et blocs de code inactifs s’effondrent.

• Afficher les séparateurs de lignes de procédure

  L’éditeur de texte indique l’étendue visuelle des procédures. Une ligne est dessinée dans les fichiers sources .cs de votre projet à des emplacements répertoriés dans le tableau suivant :

  Emplacement dans .cs fichier source	Exemple d’emplacement de ligne
  Après la fermeture d’une construction de déclaration de bloc	- À la fin d’une classe, d’une structure, d’un module, d’une interface ou d’enum - Après une propriété, une fonction ou une sous-propriété - Pas entre les clauses get et set dans une propriété
  Après un ensemble de constructions à ligne unique	- Après les instructions import, avant une définition de type dans un fichier de classe - Après les variables déclarées dans une classe, avant toutes les procédures
  Après les déclarations de ligne unique (déclarations de niveau non bloc)	- Les instructions import suivantes, héritent des instructions, des déclarations de variable, des déclarations d’événement, des déclarations de délégué et des instructions de déclaration DLL

Repères de structure de bloc

Activez ces cases à cocher pour afficher les lignes verticales en pointillés entre les crochets{} () dans votre code. Vous pouvez ensuite voir facilement des blocs de code individuels pour vos constructions au niveau de la déclaration et au niveau du code.

Commentaires

• Générer des commentaires de documentation XML pour ///

  Lorsqu’il est sélectionné, insère les éléments XML pour les commentaires de documentation XML après avoir tapé l’introduction du /// commentaire. Pour plus d’informations sur la documentation XML, consultez Commentaires de documentation XML (Guide de programmation C#).

Méthode d'extraction

• Ne placez pas de référence ou de sortie sur un struct personnalisé

  Décochez cette case pour éviter le clonage involontaire de structs de manière puissante en refendant les objets de struct existants lors de l’extraction d’une expression dans un appel de méthode.

  Exemple :

  Supposé être le suivant class et struct exister dans votre code :

  public struct CustomStruct
  {
      private int Count;
  
      public int Bump => ++Count;
  }
  
  public class CustomClass
  {
      public void DoIt()
      {
         CustomStruct cs = new CustomStruct();
         int i = 0;
  
         i += cs.Bump;   // select this line
      }
  }
  

  Si l’option « Ne pas placer ref ou out sur un struct personnalisé » est désactivée, la fonctionnalité « Extraire la méthode » génère les éléments suivants :

  public class CustomClass
  {
      public void DoIt()
      {
         CustomStruct cs = new CustomStruct();
         int i = 0;
  
         NewMethod(ref cs, ref i);
      }
  
      private static void NewMethod(ref CustomStruct cs, ref int i)
         => i += cs.Bump;
  }
  

  Si l’option « Ne pas placer ref ou out sur un struct personnalisé » est cochée, la fonctionnalité « Extraire la méthode » génère les éléments suivants :

  public class CustomClass
  {
      public void DoIt()
      {
         CustomStruct cs = new CustomStruct();
         int i = 0;
  
         i = NewMethod(cs, i);
      }
  
      private static int NewMethod(CustomStruct cs, int i)
      {
         i += cs.Bump;
         return i;
      }
  }
  

Indicateurs inline

• Indicateurs de nom de paramètre inline

  En cas de sélection, insère des indicateurs de nom de paramètre pour les littéraux, les littéraux de cast et les instanciations d’objets avant chaque argument dans les appels de fonction.

  

• Indicateurs de type inline

  Lorsque cette option est sélectionnée, insère des indicateurs de type pour les variables avec des types déduits et des types de paramètres lambda.

  

Marge d’héritage

• Lorsqu’elle est sélectionnée, ajoute des icônes aux marges représentant les implémentations et remplacements de votre code. Cliquez sur les icônes de marge d’héritage pour afficher les options d’héritage que vous pouvez sélectionner pour accéder.

  

Voir aussi

• Guide pratique pour insérer des commentaires XML pour la génération de documentation
• Documenter votre code avec des commentaires XML (Guide C#)
• Définir des options d’éditeur spécifiques à la langue
• C# IntelliSense