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
Concepts
Comment : définir un gestionnaire de liens d'éléments de travail
Comment : définir et installer une extension de modélisation