Attach reference strings to UML model elements

아티클
11/15/2016

Note

This article applies to Visual Studio 2015. If you're looking for the latest Visual Studio documentation, see Visual Studio documentation. We recommend upgrading to the latest version of Visual Studio. Download it here

You can write code to attach arbitrary strings to model elements. A string could be, for example, a URI, the cached result of a computation, or a ModelBus reference to an element in another model. Each string is contained in an IReference object. Any number of IReference objects can be attached to each model element.

Every IReference object has a Name. You could use this Name to indicate how the reference value should be interpreted. For example, you could set Name to "URI" to indicate that the Value should be interpreted as a URI. There are some predefined reference name values used by the modeling tools.

Attaching a Reference to an IElement

To use the following methods, you must add a reference to:

Microsoft.VisualStudio.ArchitectureTools.Extensibility.dll

You should insert this directive in your code:

using Microsoft.VisualStudio.ArchitectureTools.Extensibility.Uml;

Method call	Description
`element.AddReference (nameString, valueString, duplicatesAllowed)`	Creates an `IReference` with the given name and value strings, and links it to `element`. Returns the `IReference`. Throws an exception if `duplicatesAllowed` is false and there is already an `IReference` with the same name attached to `element`.
`element.GetReferences(name)`	Returns all the `IReference` objects linked to `element` that have the given `name`.
`element.DeleteAllReferences(name)`	Deletes all the `IReference` objects linked to element that have the given name.
`reference.Delete()`	Deletes this `IReference`.
`ReferenceConstants.WorkItem`	The value used to name work item references.

다음을 통해 공유

Attach reference strings to UML model elements

Attaching a Reference to an IElement

See Also

추가 리소스