Freigeben über


Gewusst wie: Anfügen von Referenzzeichenfolgen an Modellelemente

In Visual Studio Ultimate können Sie Code schreiben, um beliebige Zeichenfolgen an Modellelemente anzufügen. Eine Zeichenfolge kann beispielsweise ein URI, das zwischengespeicherte Ergebnis einer Berechnung oder ein ModelBus-Verweis auf ein Element in einem anderen Modell sein. Jede Zeichenfolge ist in einem IReference-Objekt enthalten. An jedes Modellelement kann eine beliebige Anzahl an IReference-Objekten angefügt werden.

Jedes IReference-Objekt verfügt über einen Namen. Anhand dieses Namens können Sie beispielsweise angeben, wie der Verweiswert interpretiert werden soll. So können Sie "URI" als Namen festlegen, um anzugeben, dass der Wert als URI interpretiert werden soll. Es gibt einige vordefinierte Werte für Verweisnamen, die von den Modellierungstools verwendet werden.

Anfügen eines Verweises an ein IElement

Zum Verwenden der folgenden Methoden müssen Sie einen Verweis auf Folgendes hinzufügen:

Microsoft.VisualStudio.ArchitectureTools.Extensibility.dll

Diese Direktive muss im Code eingefügt werden:

using Microsoft.VisualStudio.ArchitectureTools.Extensibility.Uml;

Methodenaufruf

Beschreibung

element.AddReference (nameString, valueString, duplicatesAllowed)

Erstellt einen IReference mit den angegebenen Namens- und Wertzeichenfolgen und verknüpft diese mit element. Gibt IReference zurück.

Löst eine Ausnahme aus, wenn duplicatesAllowed den Wert "false" aufweist und bereits ein IReference mit dem gleichen an element angefügten Namen vorhanden ist.

element.GetReferences(name)

Gibt alle IReference-Objekte zurück, die mit element verknüpft sind und den angegebenen name aufweisen.

element.DeleteAllReferences(name)

Löscht alle IReference-Objekte, die mit dem Element verknüpft sind und den angegebenen Namen aufweisen.

reference.Delete()

Löscht diese IReference.

ReferenceConstants.WorkItem

Der Wert, der zur Benennung von Verweisen auf Arbeitsaufgaben verwendet wird.

Siehe auch

Weitere Ressourcen

Gewusst wie: Definieren eines Linkhandlers für Arbeitsaufgaben

Gewusst wie: Definieren und Installieren einer Modellierungserweiterung

Programmieren mit der UML-API