Refactoring des Umbenennens eines Codesymbols

Dieses Refactoring gilt für:

• C#

• Visual Basic

Beschreibung: Hiermit können Sie Bezeichner für Codesymbole (z. B. Felder, lokale Variablen, Methoden, Namespaces, Eigenschaften und Typen) umbenennen.

Hintergrund: Sie möchten ein Element sicher umbenennen, ohne alle Instanzen suchen und den neuen Namen kopieren und einfügen zu müssen.

Vorteile: Das Kopieren und Einfügen des neuen Namens in ein ganzes Projekt würde wahrscheinlich zu Fehlern führen. Dieses Refactoringtool führt die Umbenennungsaktion ordnungsgemäß durch.

Vorgehensweise

1. Markieren Sie den Namen des umzubenennenden Elements, oder platzieren Sie den Textcursor in das Element:

   • C#:

     

   • Visual Basic:

     

2. Verwenden Sie nun die Tastatur oder Maus wie folgt:

   • Tastatur
     • Drücken Sie STRG+R und dann STRG+R. (Beachten Sie, dass Ihre Tastenkombination je nach dem gewählten Profil möglicherweise abweicht.)
   • Maus
     • Klicken Sie auf Bearbeiten > Umgestalten > Umbenennen.
     • Klicken Sie mit der rechten Maustaste auf den Code, und wählen Sie Umbenennen aus.

3. Benennen Sie das Element einfach um, indem Sie den neuen Namen eingeben.

   • C#:

     

   • Visual Basic:

     

   Tipp

   Sie können auch Kommentare und andere Zeichenfolgen vor dem Speichern mit diesem neuen Namen aktualisieren sowie eine Vorschau der Änderungen anzeigen, indem Sie oben rechts im Editor die jeweiligen Kontrollkästchen im Feld Umbenennen aktivieren.

4. Wenn Sie mit der Änderung zufrieden sind, klicken Sie auf die Schaltfläche Übernehmen, oder drücken Sie die EINGABETASTE. Die Änderungen werden angewendet.

Hinweise

• Wenn Sie ab Visual Studio 2019 Version 16.3 einen Typ umbenennen, der mit dem Namen der Datei übereinstimmt, in der er sich befindet, wird ein Kontrollkästchen angezeigt, mit dem Sie die Datei zur gleichen Zeit umbenennen können. Diese Option wird angezeigt, wenn Sie eine Klasse, eine Schnittstelle oder eine Enumeration umbenennen. Diese Option wird für partielle Typen mit mehreren Definitionen nicht unterstützt.

  

• Wenn Sie einen bereits vorhandenen Namen verwenden, der zu einem Konflikt führen würde, werden Sie durch das Feld Umbenennen darüber informiert.

  

• Eine andere Möglichkeit zum Umbenennen eines Symbols besteht darin, den Namen des Symbols im Editor zu ändern. Drücken Sie dann mit dem Cursor im Symbolnamen STRG+., oder erweitern Sie einfach das angezeigte Menü mit dem Glühbirnensymbol, und wählen Sie <Alten Namen >umbenennen in <neuen Namen>aus.

  

Siehe auch

• Refactoring
• Vorschau der Änderungen