Refactoring-Operationen in der Vorschau anzeigen und durchführen

Aus RAD Studio
Wechseln zu: Navigation, Suche

Nach oben zu Refactoring – Anleitungen


Bei den meisten Refactoring-Operationen können die Auswirkungen vor der Durchführung im Fenster Refactorings angezeigt werden. Einige Operationen unterstützen jedoch keine Vorschau und werden sofort durchgeführt. In der Vorschau wird angezeigt, wie die Refactoring-Engine Operationen für die verschiedenen Arten von Bezeichnern und anderen Refactoring-Zielen auswertet und ausführt. Die Vorschau wird per Voreinstellung angezeigt. Während der Vorschau einer Operation sammelt die Engine in einem Hintergrund-Thread Refactoring-Informationen und zeigt diese sofort an.

Die Verarbeitung in einem Hintergrund-Thread erfolgt auch bei Refactoring-Operationen, die sofort (ohne Vorschau) durchgeführt werden. Hier wird lediglich durch ein modales Dialogfeld die Anzeige unterdrückt. Falls während des Sammelns von Informationen ein Fehler auftritt, führt die Refactoring-Engine die Operation nicht aus. Refactoring-Operationen werden von der Engine nur umgesetzt, wenn die Informationssammlung fehlerlos abgeschlossen werden konnte.

So zeigen Sie eine Umbenennen-Operation in der Vorschau an und führen sie aus:

  1. Öffnen Sie ein Projekt.
  2. Klicken Sie im Quelltext-Editor mit der rechten Maustaste auf einen Bezeichner, um das Kontextmenü zu öffnen.
  3. Wählen Sie den Befehl Refactor > Umbenennen <Bezeichnertyp> <Bezeichnername> aus dem Kontextmenü. Der Kontextmenübefehl Umbenennen ist kontextsensitiv; er zeigt den tatsächlichen Namen Bezeichnername des ausgewählten Bezeichners und seinen Typ Bezeichnertyp (Methode, Typ, Variable, Feld etc.) an. Das Dialogfeld Umbenennen <Bezeichnertyp> <Bezeichnername> wird geöffnet.
  4. Geben Sie einen neuen Bezeichnernamen in das Feld Neuer Name ein.
  5. Aktivieren Sie das Kontrollkästchen Vor Refactoring Referenzen anzeigen.
  6. Klicken Sie auf OK. Das Fenster Refactorings wird geöffnet, und eine hierarchische Liste aller Elemente angezeigt, die potenziell umbenannt werden sollen. Sie können im Quelltext-Editor zu den einzelnen Elementen wechseln.
  7. Klicken Sie im Fenster Refactorings auf das Symbol Refactoring übernehmen, um alle Refactoring-Operationen auszuführen.

Hinweis: Wenn das Kontrollkästchen Vor Refactoring Referenzen anzeigen nicht aktiviert ist, wird das Refactoring sofort beim Anklicken von OK ausgeführt.

Hinweis: Soll ein Element in der Refactoring-Operation nicht berücksichtigt werden, wählen Sie es im Fenster Refactorings aus und klicken in der Symbolleiste auf das Symbol Refactoring entfernen.

Warnung: Falls die Engine während der Operation Fehler feststellt, wird das Refactoring nicht durchgeführt. Die Fehler werden im Fenster Refactorings angezeigt.

So wechseln Sie vom Refactorings-Fenster aus zu einem Refactoring-Ziel:

  1. Erweitern Sie einen der Knoten im Fenster Refactorings.
  2. Klicken Sie auf den Ziel-Refactoring-Bezeichner, der im Quelltext-Editor angezeigt werden soll.
  3. Nehmen Sie die erforderlichen Änderungen im Quelltext-Editor vor.

Warnung: Wenn Sie ein Element im Quelltext-Editor ändern, wird die Refactoring-Operation verhindert. Wenn Sie während des Refactoring-Prozesses Änderungen an Dateien vornehmen, müssen Sie die Refactoring-Operation anschließend erneut durchführen.

Siehe auch