Aperçu et application des opérations de refactoring

De RAD Studio
Aller à : navigation, rechercher

Remonter à Procédures de refactoring


Vous pouvez prévisualiser la plupart des opérations de refactoring dans le volet Refactorings. Certains refactorings se produisent immédiatement et ne peuvent pas être prévisualisés. La prévisualisation vous montre comment le moteur de refactoring évalue et applique les opérations de refactoring à divers types d'identificateurs et à d'autres cibles de refactoring. La prévisualisation est définie comme le comportement par défaut. Quand vous prévisualisez une opération de refactoring, le moteur collecte les informations de refactoring dans un thread en arrière-plan et remplit les informations au fur et à mesure de leur collecte.

Si vous appliquez immédiatement une opération de refactoring, elle s'effectue aussi dans un thread en arrière-plan, mais une boîte de dialogue modale bloque l'activité de l'interface utilisateur. Si le moteur de refactoring rencontre une erreur pendant la phase de collecte des informations de l'opération, il n'applique pas l'opération de refactoring. Il ne l'applique que s'il ne détecte aucune erreur pendant cette phase.

Pour prévisualiser et appliquer l'opération Renommer :

  1. Ouvrez un projet.
  2. Dans l'éditeur de code, cliquez avec le bouton droit sur un identificateur pour afficher le menu contextuel.
  3. Sélectionnez la commande Refactor > Renommer TypeIdentificateur NomIdentificateur du menu contextuel. La commande Renommer du menu contextuel est sensible au contexte. Elle présente le nom réel NomIdentificateur de l'identificateur sélectionné et son type TypeIdentificateur (méthode, type, variable, champ, etc.). Cette opération affiche la boîte de dialogue Renommer TypeIdentificateur NomIdentificateur.
  4. Tapez un nouveau nom d'identificateur dans la zone de texte Nouveau nom.
  5. Cochez la case Voir les références avant le refactoring.
  6. Cliquez sur OK. Cette opération ouvre le volet Refactorings et affiche une liste hiérarchique de tous les éléments potentiellement renommables. Vous pouvez accéder à chacun de ces éléments dans l'éditeur de code.
  7. Cliquez sur l'icône Appliquer le refactoring dans le volet Refactorings pour appliquer toutes les opérations de refactoring.

Remarque : Tant que la case Voir les références avant le refactoring n'est pas cochée, le refactoring se produit dès que vous cliquez sur OK.

Remarque : Pour retirer un élément de l'opération de refactoring, sélectionnez-le dans le volet Refactorings et cliquez sur l'icône Retirer le refactoring de la barre d'outils.

Avertissement : Si le moteur de refactoring rencontre des erreurs, le refactoring n'est pas appliqué. Les erreurs sont affichées dans le volet Refactorings.

Pour accéder à une cible de refactoring depuis le volet Refactorings :

  1. Développez tous les noeuds qui apparaissent dans le volet Refactorings.
  2. Cliquez sur l'identificateur de refactoring cible que vous voulez visualiser dans l'éditeur de code.
  3. Apportez vos modifications dans l'éditeur de code.

Avertissement : Si vous modifiez un élément dans l'éditeur de code, l'opération de refactoring est impossible. Vous devez réappliquer le refactoring après avoir modifié des fichiers pendant le processus de refactoring.

Voir aussi