Refactoring-Operationen in der Vorschau anzeigen und durchführen
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:
- Öffnen Sie ein Projekt.
- Klicken Sie im Quelltext-Editor mit der rechten Maustaste auf einen Bezeichner, um das Kontextmenü zu öffnen.
- 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.
- Geben Sie einen neuen Bezeichnernamen in das Feld Neuer Name ein.
- Aktivieren Sie das Kontrollkästchen Vor Refactoring Referenzen anzeigen.
- 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.
- 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:
- Erweitern Sie einen der Knoten im Fenster Refactorings.
- Klicken Sie auf den Ziel-Refactoring-Bezeichner, der im Quelltext-Editor angezeigt werden soll.
- 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.