Share via


Cómo: Adjuntar cadenas de referencia a elementos de modelo

En Visual Studio Ultimate, puede escribir código para adjuntar cadenas arbitrarias a elementos del modelo.Una cadena podría ser, por ejemplo, un identificador URI, el resultado almacenado en caché de un cálculo o una referencia de ModelBus a un elemento de otro modelo.Cada cadena está incluida en un objeto IReference.Se puede adjuntar cualquier número de objetos IReference a cada elemento del modelo.

Cada objeto IReference tiene un nombre.Puede usar este nombre para indicar cómo debe interpretarse el valor de referencia.Por ejemplo, puede establecer el nombre en "URI" para indicar que el valor debe interpretarse como un identificador URI.Hay algunos valores de nombres de referencia predefinidos que se usan en las herramientas de modelado.

Adjuntar una referencia a un objeto IElement

Para usar los siguientes métodos, debe agregar una referencia a:

Microsoft.VisualStudio.ArchitectureTools.Extensibility.dll

Debe insertar esta directiva en el código:

using Microsoft.VisualStudio.ArchitectureTools.Extensibility.Uml;

Llamada a método

Descripción

element.AddReference (nameString, valueString, duplicatesAllowed)

Crea IReference con las cadenas de valor y nombre especificadas y lo vincula a element.Devuelve IReference.

Genera una excepción si duplicatesAllowed es false y existe ya un objeto IReference con el mismo nombre adjuntado a element.

element.GetReferences(name)

Devuelve todos los objetos IReference vinculados a element que tienen el valor de name especificado.

element.DeleteAllReferences(name)

Elimina todos los objetos IReference vinculados al elemento que tiene el nombre especificado.

reference.Delete()

Elimina este objeto IReference.

ReferenceConstants.WorkItem

Valor que se usa para asignar un nombre a las referencias de elementos de trabajo.

Vea también

Conceptos

Cómo: Definir un controlador de vínculos de elementos de trabajo

Cómo: Definir e instalar una extensión de modelado

Programar con la API de UML