Condividi tramite


Procedura: allegare stringhe di riferimento agli elementi di modello

In Visual Studio Ultimate è possibile scrivere codice per allegare stringhe arbitrarie agli elementi di modello.Una stringa potrebbe essere, ad esempio, un URI, il risultato memorizzato nella cache di un calcolo o un riferimento ModelBus a un elemento in un altro modello.Ogni stringa è contenuta in un oggetto IReference.A ogni elemento di modello può essere allegato il numero desiderato di oggetti IReference.

Ogni oggetto IReference presenta un nome.Questo nome può essere utilizzato per indicare come interpretare il valore di riferimento.Ad esempio, è possibile impostare il nome su "URI" per indicare che il valore deve essere interpretato come un URI.Esistono alcuni valori di nome di riferimento predefiniti utilizzati dagli strumenti di modellizzazione.

Associazione di un riferimento a un oggetto IElement

Per utilizzare i metodi seguenti, è necessario aggiungere un riferimento a:

Microsoft.VisualStudio.ArchitectureTools.Extensibility.dll

Inserire la direttiva seguente nel codice:

using Microsoft.VisualStudio.ArchitectureTools.Extensibility.Uml;

Chiamata ai metodi

Descrizione

element.AddReference (nameString, valueString, duplicatesAllowed)

Crea un oggetto IReference con le stringhe di nome e valore specificate e lo collega a element.Restituisce IReference.

Genera un'eccezione se duplicatesAllowed è falso ed è già presente un oggetto IReference con lo stesso nome associato a element.

element.GetReferences(name)

Restituisce tutti gli oggetti IReference collegati a element aventi l'oggetto name specificato.

element.DeleteAllReferences(name)

Elimina tutti gli oggetti IReference collegati all'elemento aventi il nome specificato.

reference.Delete()

Elimina questo oggetto IReference.

ReferenceConstants.WorkItem

Valore utilizzato per denominare i riferimenti agli elementi di lavoro.

Vedere anche

Concetti

Procedura: definire un gestore dei collegamenti agli elementi di lavoro

Procedura: definire e installare un'estensione di modellazione

Programmazione con l'API UML