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
Konzepte
Gewusst wie: Definieren eines Linkhandlers für Arbeitsaufgaben
Gewusst wie: Definieren und Installieren einer Modellierungserweiterung