CodeElement2.RenameSymbol-Methode

Článek
08/23/2008

Aktualisiert: November 2007

Ändert den deklarierten Namen eines Objekts und aktualisiert alle Codeverweise auf das Objekt im Gültigkeitsbereich des aktuellen Projekts.

Namespace: EnvDTE80
Assembly: EnvDTE80 (in EnvDTE80.dll)

Syntax

'Declaration
Sub RenameSymbol ( _
    NewName As String _
)
'Usage
Dim instance As CodeElement2
Dim NewName As String

instance.RenameSymbol(NewName)

void RenameSymbol(
    string NewName
)

void RenameSymbol(
    String^ NewName
)

function RenameSymbol(
    NewName : String
)

Parameter

NewName
Typ: System.String

Erforderlich. Der Name des Symbols, das umbenannt werden soll.

Hinweise

Wenn ein beliebiger Teil nicht umbenannt werden kann (im Gültigkeitsbereich des aktuellen Projekts), gibt die Methode einen Fehler zurück.

Hinweis:
Sie können RenameSymbol oder ElementID nicht spät gebunden aufrufen. (Beispiel: DTE.ActiveDocument.ProjectItem.FileCodeModel.CodeElements.Item("Class1").RenameSymbol("Class2")) Sie müssen das Objekt vor dem Aufrufen explizit in die CodeElement2-Schnittstelle umwandeln. Codeelemente in EnvDTE80 (im Folgenden als Code2-Objekte bezeichnet) werden von Codeelementen in EnvDTE abgeleitet. (Beispielsweise wird CodeClass2 von CodeClass und CodeElement2 von CodeElement abgeleitet.) In Visual Studio werden alle Codeelemente (in beiden Assemblys) intern in CodeElement2 umgewandelt. Folgerichtig scheint CodeClass2 beispielsweise letztendlich von CodeElement2 abgeleitet zu werden. Da die beiden Elemente sich jedoch tatsächlich in zwei separaten Vererbungshierarchien befinden, können CodeElement2-Methoden bei Code2-Objekten nicht spät gebunden aufgerufen werden. EnvDTE wird im Wesentlichen auf die gleiche Weise verwendet, durch die Verwendung von Präprozessormakros können die Schnittstellen jedoch so festgelegt werden, dass vererbte Methoden explizit für alle relevanten Schnittstellen mit vorhandenen Konvertierungen definiert werden. EnvDTE80-Schnittstellen werden unter Verwendung eines ähnlichen Vererbungsschemas definiert, jedoch ohne die Verwendung von Präprozessoranweisungen. Dabei handelt es sich um eine elegantere Lösung, da die redundanten Eigenschaften entfernt werden. Die Eigenschaften können jedoch nicht spät gebunden aufgerufen werden. Wandeln Sie das Objekt vor dem Aufrufen explizit in die CodeElement2-Schnittstelle um, um dieses Problem zu umgehen. Außerdem können die Werte von Codemodellelementen wie Klassen, Strukturen, Funktionen, Attributen, Delegaten usw. nach bestimmten Bearbeitungsvorgängen nicht deterministisch sein, d. h., dass nicht mehr davon ausgegangen werden kann, dass ihre Werte immer unverändert bleiben. Weitere Informationen finden Sie im Abschnitt zum Änderungsverhalten von Codemodellelementwerten unter Ermitteln von Code über das Codemodell (Visual Basic).

Sie können RenameSymbol oder ElementID nicht spät gebunden aufrufen. (Beispiel: DTE.ActiveDocument.ProjectItem.FileCodeModel.CodeElements.Item("Class1").RenameSymbol("Class2")) Sie müssen das Objekt vor dem Aufrufen explizit in die CodeElement2-Schnittstelle umwandeln.

Codeelemente in EnvDTE80 (im Folgenden als Code*2-Objekte bezeichnet) werden von Codeelementen in EnvDTE abgeleitet. (Beispielsweise wird CodeClass2 von CodeClass und CodeElement2 von CodeElement abgeleitet.) In Visual Studio werden alle Codeelemente (in beiden Assemblys) intern in CodeElement2 umgewandelt. Folgerichtig scheint CodeClass2 beispielsweise letztendlich von CodeElement2 abgeleitet zu werden.

Da die beiden Elemente sich jedoch tatsächlich in zwei separaten Vererbungshierarchien befinden, können CodeElement2-Methoden bei Code*2-Objekten nicht spät gebunden aufgerufen werden. EnvDTE wird im Wesentlichen auf die gleiche Weise verwendet, durch die Verwendung von Präprozessormakros können die Schnittstellen jedoch so festgelegt werden, dass vererbte Methoden explizit für alle relevanten Schnittstellen mit vorhandenen Konvertierungen definiert werden. EnvDTE80-Schnittstellen werden unter Verwendung eines ähnlichen Vererbungsschemas definiert, jedoch ohne die Verwendung von Präprozessoranweisungen. Dabei handelt es sich um eine elegantere Lösung, da die redundanten Eigenschaften entfernt werden. Die Eigenschaften können jedoch nicht spät gebunden aufgerufen werden. Wandeln Sie das Objekt vor dem Aufrufen explizit in die CodeElement2-Schnittstelle um, um dieses Problem zu umgehen.

Außerdem können die Werte von Codemodellelementen wie Klassen, Strukturen, Funktionen, Attributen, Delegaten usw. nach bestimmten Bearbeitungsvorgängen nicht deterministisch sein, d. h., dass nicht mehr davon ausgegangen werden kann, dass ihre Werte immer unverändert bleiben. Weitere Informationen finden Sie im Abschnitt zum Änderungsverhalten von Codemodellelementwerten unter Ermitteln von Code über das Codemodell (Visual Basic).

Berechtigungen

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.