如何:将引用字符串附加到模型元素

在 Visual Studio 旗舰版中,可以编写代码以将任意字符串附加到模型元素。 例如,字符串可以是 URI、计算的缓存结果或对另一个模型中的某个元素的 ModelBus 引用。 每个字符串均包含在一个 IReference 对象中。 可以将任意数量的 IReference 对象附加到每个模型元素。

每个 IReference 对象均有一个名称。 可以使用此名称来指示应如何解释引用值。 例如,可以将名称设置为“URI”以指示应将值解释为 URI。 有一些可供建模工具使用的预定义的引用名称值。

附加对 IElement 的引用

若要使用下列方法,您必须添加对以下项的引用:

Microsoft.VisualStudio.ArchitectureTools.Extensibility.dll

您应将该指令插入代码中:

using Microsoft.VisualStudio.ArchitectureTools.Extensibility.Uml;

方法调用

说明

element.AddReference (nameString, valueString, duplicatesAllowed)

使用给定的名称和值字符串创建一个 IReference,并将其链接到 element。 返回 IReference。

如果 duplicatesAllowed 为 false 且已存在一个附加到 element 的同名 IReference,则将引发异常。

element.GetReferences(name)

返回所有链接到 element 的具有给定 name 的 IReference 对象。

element.DeleteAllReferences(name)

删除所有链接到 element 的具有给定 name 的 IReference 对象。

reference.Delete()

删除此 IReference。

ReferenceConstants.WorkItem

用于命名工作项引用的值。

请参见

任务

如何:定义工作项链接处理程序

概念

使用 UML API 编程

其他资源

如何:定义和安装建模扩展