CodeElement2.ElementID-Eigenschaft

Artikel
08/10/2011

Ruft einen Wert ab, der das Element eindeutig kennzeichnet. Nicht implementiert in Visual C#.

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

Syntax

'Declaration
ReadOnly Property ElementID As String
    Get

string ElementID { get; }

property String^ ElementID {
    String^ get ();
}

abstract ElementID : string

function get ElementID () : String

Eigenschaftswert

Typ: System.String
Eine Zeichenfolge, die den eindeutigen Wert für das Element darstellt.

Hinweise

Die ElementID-Eigenschaft ist ein Wert, der auf der Grundlage des Elementnamens und anderer Informationen berechnet wird, die das Element eindeutig kennzeichnen. Die genaue Berechnung der ID variiert zwischen den Sprachen.

Diese ID wird von Codemodellclients verwendet, um Elemente ohne Beibehaltung von Verweisen zu verfolgen. Sie wird in Codemodellereignisse aufgenommen, um den Clientcode über das geänderte Element zu informieren. Neue IDs werden bereitgestellt, wenn sie erstellt werden.

Der Wert der ElementID-Eigenschaft sollte nicht als permanent betrachtet werden. Der Wert ändert sich wahrscheinlich jedes Mal, wenn das Codemodell für ein Projekt erstellt wird, und er kann sich auch in der aktuellen Sitzung ändern. Ein ElementChanged-Ereignis tritt jedes Mal auf, wenn sich die ElementID ändert.

Tipp

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 zwei Elemente in Wirklichkeit in zwei separaten Vererbungshierarchien enthalten sind, kann der latebinder keine CodeElement2-Methoden für Code*2-Objekte suchen. EnvDTE funktioniert grundsätzlich auf dieselbe Weise, aber die Verwendung von Präprozessormakros lässt die Schnittstellen zu, die so definiert werden sollen, dass diese geerbten Methoden explizit auf alle verwandten Schnittstellen definiert werden, für die Konvertierungen vorhanden sind. EnvDTE80-Schnittstellen werden mithilfe eines ähnlichen Vererbungsschema definiert, nur 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).

.NET Framework-Sicherheit

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.