Renommer un symbole de code (refactorisation)

Cette refactorisation s’applique à :

  • C#

  • Visual Basic

Quoi : vous permet de renommer des identificateurs pour des symboles de code, tels que des champs, variables locales, méthodes, espaces de noms, propriétés et types.

Quand : vous voulez renommer en toute sécurité un élément sans avoir à rechercher toutes les instances et à copier/coller le nouveau nom.

Pourquoi : un copier-coller du nouveau nom dans un projet entier entraînera probablement des erreurs. Cet outil de refactorisation effectuera avec précision le changement de nom.

Procédures

  1. Mettez en surbrillance ou placez le curseur de texte dans l’élément à renommer :

    • C# :

      Highlighted code - C#

    • Visual Basic :

      Highlighted code - Visual Basic

  2. Ensuite, utilisez votre clavier ou votre souris comme suit :

    • Clavier
      • Appuyez sur Ctrl+R, puis Ctrl+R. (Notez que le raccourci clavier peut varier en fonction du profil que vous avez sélectionné.)
    • Souris
      • Sélectionnez Modifier > Refactoriser > Renommer.
      • Cliquez avec le bouton droit et sélectionnez Renommer.
  3. Renommez l’élément en tapant le nouveau nom.

    • C# :

      Rename animation - C#

    • Visual Basic :

      Rename - VB

    Astuce

    Vous pouvez aussi mettre à jour les commentaires et d’autres chaînes pour utiliser ce nouveau nom, et afficher un aperçu des changements avant de les enregistrer, en utilisant les cases à cocher de la boîte de dialogue Renommer qui apparaît en haut à droite de votre éditeur.

  4. Quand vous êtes satisfait du changement, appuyez sur le bouton Appliquer ou sur la touche Entrée pour valider les changements.

Notes

  • Depuis Visual Studio 2019 version 16.3, quand vous renommez un type correspondant au nom du fichier dans lequel il se trouve, une case à cocher s’affiche pour vous permettre de renommer le fichier en même temps. Cette option s’affiche quand vous renommez une classe, une interface ou une énumération. Cette option n’est pas prise en charge pour les types partiels à plusieurs définitions.

    Rename animation with file - C#

  • Si vous utilisez un nom qui existe déjà, ce qui provoquerait un conflit, la boîte de dialogue Renommer vous avertit.

    Rename Conflict

  • Une autre façon de renommer un symbole consiste à modifier son nom dans l’éditeur. Placez le curseur dans le nom du symbole, appuyez sur Ctrl+. ou développez simplement le menu de l’icône d’ampoule qui s’affiche, puis choisissez Renommer <ancien nom> en <nouveau nom>.

    Rename in the editor

Voir aussi