Partager via


Comment : attacher des chaînes de référence à des éléments de modèle

Dans Visual Studio Ultimate, vous pouvez écrire le code pour attacher des chaînes arbitraires aux éléments de modèle. Par exemple, une chaîne pourrait être un URI, le résultat mis en cache d'un calcul, ou une référence ModelBus à un élément dans un autre modèle. Chaque chaîne est contenue dans un objet IReference. Un nombre quelconque d'objets IReference peut être attaché à chaque élément de modèle.

Chaque objet IReference a un nom. Vous pourriez utiliser ce nom pour indiquer comment la valeur de référence doit être interprétée. Par exemple, vous pourriez affecter au Nom la valeur « URI » pour indiquer que la valeur doit être interprétée comme un URI. Il y a quelques valeurs de noms de référence prédéfinies utilisées par les outils de modélisation.

Attachement d'une référence à un IElement

Pour utiliser les méthodes suivantes, vous devez ajouter une référence à :

Microsoft.VisualStudio.ArchitectureTools.Extensibility.dll

Vous devez insérer cette directive dans votre code :

using Microsoft.VisualStudio.ArchitectureTools.Extensibility.Uml;

Appel de méthode

Description

element.AddReference (nameString, valueString, duplicatesAllowed)

Crée un IReference avec les chaînes de valeur et de nom donné, et les lie à element. Retourne l'IReference.

Lève une exception si duplicatesAllowed est faux et s'il existe déjà un IReference avec le même nom attaché à element.

element.GetReferences(name)

Retourne tous les objets IReference liés à element qui ont le name donné.

element.DeleteAllReferences(name)

Supprime tous les objets IReference liés à l'élément qui a le nom donné.

reference.Delete()

Supprime cet IReference.

ReferenceConstants.WorkItem

Valeur utilisée pour nommer des références d'éléments de travail.

Voir aussi

Autres ressources

Comment : définir un gestionnaire de liens d'éléments de travail

Comment : définir et installer une extension de modélisation

Programmation à l'aide de l'API UML