Modificare e personalizzare grafici dipendenze
È possibile modificare i grafici dipendenze senza influire sul codice sottostante.Ciò risulta utile per concentrarsi sugli elementi principali o per comunicare informazioni sul codice.Ad esempio, per evidenziare le aree interessanti, è possibile selezionare nodi e filtrarli, modificare lo stile di nodi e collegamenti, nascondere o nodi di eliminazione e organizzare nodi mediante le proprietà, delle categorie, o i gruppi.
È inoltre possibile personalizzare ulteriormente il grafico modificando il file Directed Graph Markup Language (.dgml) del grafico.È ad esempio possibile modificare degli elementi per specificare stili personalizzati, assegnare proprietà e categorie a nodi e collegamenti o collegare nodi a elementi quali documenti, URL e altri grafi.
[!NOTA]
Visual studio esegue la pulizia di tutti gli attributi e gli elementi DGML inutilizzati che vengono eliminati quando si salva il file con estensione .dgml.Vengono inoltre creati automaticamente elementi nodo quando si aggiungono manualmente nuovi collegamenti. Quando si salva il file con estensione .dgml, tutti gli attributi aggiunti a un elemento si ridispongono in ordine alfabetico.Per ulteriori informazioni sugli elementi DGML, vedere Informazioni su DGML (Directed Graph Markup Language).
Requisiti
Visual Studio ultimate, Visual Studio Premium, o Visual Studio Professional
Per creare grafici dipendenze, è necessario disporre di Visual Studio Ultimate.Vedere Visualizzare le dipendenze di codice nei grafici dipendenze.
In questo argomento
Selezionare i nodi o i collegamenti
Rinominare collegamenti o i nodi
Visualizzare o nascondere i nodi e i collegamenti
Aggiungere nodi e collegamenti
Aggiungere commenti al grafico
Eliminare nodi
Raggruppare nodi
Unire i grafici
Modificare lo stile del grafico
Modificare lo stile di collegamento o del nodo
Copiare stili da un grafico a un altro
Assegnare proprietà a nodi e collegamenti
Assegnare categorie a nodi e collegamenti
Collegare elementi ai nodi o ai collegamenti
Creare alias per percorsi di utilizzo comune
Selezionare i nodi o i collegamenti
Per |
Eseguire questi passaggi |
|---|---|
Selezionare tutti i nodi non selezionati |
Aprire il menu di scelta rapida per i nodi selezionati.Scegliere Seleziona, Inverti selezione. |
Selezionare nodi aggiuntivi che si collegano a quelli selezionati |
Aprire il menu di scelta rapida per i nodi selezionati.Scegliere Seleziona e uno dei seguenti:
|
Rinominare collegamenti o i nodi
Selezionare il nodo o il collegamento.Premere F2.Quando la casella di modifica viene visualizzata, rinominare il nodo o il collegamento.
Se l'etichetta è visibile, selezionare l'etichetta.
Visualizzare o nascondere i nodi e i collegamenti
Nascondere i nodi impedisce loro la partecipazione in algoritmi di layout.Per impostazione predefinita, i collegamenti tra gruppi sono nascosti.I collegamenti tra gruppi sono collegamenti singoli che connettono nodi tra gruppi.Quando i gruppi vengono compressi, tutti i collegamenti tra gruppi presenti nel grafico vengono aggregati in singoli collegamenti tra gruppi.Quando si espande un gruppo e i nodi selezionati nel gruppo, i collegamenti tra gruppi vengono visualizzati mostrando le dipendenze nel gruppo.
.gif "Nota di avviso") Attenzione |
|---|
Prima di condividere un grafico creato in Visual Studio Ultimate con coloro che utilizzano Visual Studio Premium o il Visual Studio Professional,assicurarsi di rendere visibili tutti i nodi o i collegamenti tra gruppi che desidera gli altri vedano.In caso contrario, gli utenti non saranno in grado di vedere tali elementi. |
Nascondere o mostrare nodi
Per |
Eseguire questi passaggi |
|---|---|
Nascondere nodi selezionati |
|
Nascondere nodi non selezionati |
|
Mostra nodi nascosti |
|
Nascondere i nodi modificando il file con estensione .dgml |
|
.gif "Icona Scopri figli")
nell'angolo in alto a sinistra del gruppo.Per mostrare o nascondere collegamenti
Per |
Nella barra degli strumenti del grafico, aprire l'elenco Cambia la modalità di visualizzazione dei collegamenti nel grafico o aprire il menu di scelta rapida del grafico. Scegliere: |
|---|---|
Mostrare sempre tutti i collegamenti tra gruppi |
Mostra tutti i collegamenti tra gruppi Questo nasconde i collegamenti aggregati tra gruppi. |
Mostra solo i collegamenti tra gruppi per i nodi selezionati |
Mostra collegamenti tra gruppi nei nodi selezionati |
Nascondere sempre tutti i collegamenti tra gruppi |
Nascondere i collegamenti tra gruppi |
Nascondere tutti i collegamenti (o mostrare tutti i collegamenti) |
Nascondi tutti i collegamenti Per mostrare tutti i collegamenti, fare nuovamente clic su Nascondi tutti i collegamenti tra gruppi per disattivare questa modalità. |
Aggiungere nodi e collegamenti
Aggiungere un nuovo nodo non definito |
Eseguire questi passaggi |
|---|---|
Posizione corrente del puntatore |
Selezionare una posizione nel grafico dove inserire il nuovo nodo.Premere Inserisci. |
Questo si collega al nodo selezionato |
|
Questo collega un nodo esistente con lo stato attivo corrente |
Premere TAB fino al nodo cui si desidera collegare lo stato attivo.Premere ALT+Shift+Inserisci. |
.gif "Barra degli strumenti del grafico - Creare un nodo con collegamento")
.Aggiungere nodi per |
Eseguire questi passaggi |
|---|---|
Elementi nella soluzione |
|
Elementi correlati ai nodi nel grafico |
Aprire il menu di scelta rapida del nodo.Scegliere Mostra e il tipo di relazione che interessa. Per un assembly, scegliere:
Per una classe, scegliere:
Per un metodo, scegliere:
Per un campo, scegliere:
|
Assembly .NET compilati (file dll o exe) o file binari |
Utilizzare Esplora architettura per trovare e trascinare gli elementi e le relazioni nel grafico. |
Per aggiungere un collegamento tra i nodi esistenti
Selezionare il nodo di origine.
Una barra degli strumenti apparirà sopra il nodo.
.png "Barra degli strumenti del grafico delle dipendenze")
Sulla barra degli strumenti, scegliere Crea un nuovo collegamento da questo nodo ad ogni nodo su cui ci cliccherà in futuro
.gif "Barra degli strumenti del grafico - Creare un collegamento")
.Selezionare il nodo di destinazione.Viene visualizzato un collegamento tra due nodi.
Aggiungere commenti al grafico
Selezionare il nodo in cui si desidera aggiungere un commento collegato.
Una barra degli strumenti apparirà sopra il nodo.
Sulla barra degli strumenti, scegliere Crea un nuovo nodo commento con un nuovo collegamento al nodo selezionato
.png "Barra degli strumenti del grafico - Creare un commento con collegamento")
.Digitare i commenti.Per inserire una nuova riga, premere SHIFT+INVIO.
Eliminare nodi
È possibile eliminare i nodi da un grafico senza influenzare il codice sottostante.Per eliminare un nodo, selezionare il nodo quindi premere il tasto CANC.Quando si eliminano i nodi, le relative definizioni vengono rimosse dal file DGML (estensione .dgml).
Quando si eliminano i nodi da un gruppo, il pulsante .png "Icona Recupera di nuovo figli")
Recupera di nuovo figli verrà visualizzato nel gruppo.Per recuperare i nodi mancanti, scegliere Recupera figli.I grafici creati modificando il DGML, aggiungendo i nodi non definiti, o usando versioni precedenti di Visual Studio Ultimate, non supporteranno questa funzionalità.
| Attenzione |
|---|
Prima di condividere un grafico creato mediante Visual Studio Ultimate con coloro che utilizzano Visual Studio Premium o Visual Studio Professional, assicurarsi che tutti i nodi che si desidera gli altri vedano siano visibili nel grafico.In caso contrario, gli utenti non saranno in grado di recuperare i nodi eliminati. |
Raggruppare nodi
Per |
Eseguire questi passaggi |
|---|---|
Mostra nodi contenitore come nodi gruppo o nodi foglia. |
Per visualizzare i nodi del contenitore come nodi foglia, selezionare i nodi.Aprire il menu di scelta rapida per la selezione.Scegliere Gruppo, Converti in foglia. Per visualizzare i nodi del contenitore come nodi di gruppo, selezionare i nodi.Aprire il menu di scelta rapida per la selezione.Scegliere Gruppo, Converti in gruppo. Per mostrare tutti i nodi foglia come nodi di gruppo, aprire il menu di scelta rapida del grafico.Scegliere Gruppo, Abilita raggruppamento. Per mostrare tutti i nodi foglia come nodi di gruppo, aprire il menu di scelta rapida del grafico.Scegliere Gruppo, Disabilita raggruppamento. |
Aggiungere un nodo a un gruppo |
Trascinare il nodo nel gruppo. È inoltre possibile trascinare i nodi da un gruppo. |
Aggiungere un nodo a un nodo di non-gruppo |
È possibile convertire qualsiasi nodo in un gruppo.Trascinare il nodo nel nodo di destinazione. |
Raggruppare nodi selezionati |
|
Raggruppare nodi con categorie o proprietà specifiche |
|
Raggruppare nodi in base ai relativi valori delle proprietà |
|
Rimuovere gruppi |
Selezionare il gruppo o i gruppi che si desidera rimuovere.Aprire il menu di scelta rapida per la selezione.Scegliere Gruppo, Rimuovi gruppo. |
Rimuovere nodi dal relativo gruppo padre fino al padre del padre, oppure all'esterno di un gruppo se non dispongono di un gruppo padre del padre |
Selezionare i nodi che si desidera spostare.Aprire il menu di scelta rapida per la selezione.Scegliere Gruppo, Rimuovi dall'elemento padre. |
.gif "Barra degli strumenti del grafico - Gruppo selezionato")
.Per raggruppare nodi modificando il file con estensione dgml del grafico
Per convertire un nodo in un gruppo, aprire il menu di scelta rapida del nodo.Scegliere Vai, DGML.
Visual Studio apre il file con estensione dgml del grafico e viene evidenziato l'elemento <Node/> relativo a tale nodo.
In alternativa
Per aggiungere un nuovo gruppo di file:
Aprire il menu di scelta rapida per un'area vuota del grafico.Scegliere Vai, DGML.
Nella sezione <Node/> aggiungere un nuovo elemento <Nodes>.
Nell'elemento <Node/> aggiungere un attributo Group per specificare se il gruppo viene visualizzato espanso o compresso.Ad esempio:
<Nodes> <Node Id="MyFirstGroup" Group="Expanded" /> <Node Id="MySecondGroup" Group="Collapsed" /> </Nodes>Nella sezione <Links> assicurarsi che sia presente un elemento <Link/> con gli attributi seguenti per ogni relazione tra un nodo di gruppo e i relativi nodi figlio:
Attributo Source che specifica il nodo di gruppo
Attributo Target che specifica il nodo figlio
Attributo Category che specifica una relazione Contains tra il nodo di gruppo e il relativo nodo figlio
Ad esempio:
<Links> <Link Category="Contains" Source="MyFirstNewGroup" Target="FirstGroupChildOne" /> <Link Category ="Contains" Source="MyFirstNewGroup" Target="FirstGroupChildTwo" /> <Link Category ="Contains" Source="MySecondNewGroup" Target="SecondGroupChildOne" /> <Link Category="Contains" Source="MySecondNewGroup" Target="SecondGroupChildTwo" /> </Links>Per ulteriori informazioni sull'attributo Category, vedere Assegnare categorie a nodi e collegamenti.
Unire i grafici
È possibile unire grafici copiando e incollando i nodi tra i grafici.Se gli identificatori di nodo corrispondono, incollare le funzioni dei nodi come un'operazione di unione.Per semplificare questa attività più semplice, inserire tutti gli assembly o file binari che si desidera visualizzare nella stessa cartella in modo che il percorso completo di ogni assembly o binario sia lo stesso per ogni grafico da unire.
In alternativa, è possibile creare un singolo grafico per gli assembly o binari che si desidera visualizzare eseguendo uno dei passaggi seguenti:
Trascinare gli assembly o binari allo stesso grafico.
In alternativa
Aprire Esplora architettura:In File system, scegliere Seleziona file per esplorare, quindi aprire gli assembly o binari.Per perfezionare il grafico, selezionare gli elementi specifici che si desidera visualizzare.Al termine, scegliere Crea un nuovo documento grafico dai nodi selezionati nella barra degli strumenti Esplora architettura.
Modificare lo stile del grafico
È possibile modificare il colore di sfondo e del bordo del grafico modificando il file con estensione dgml del grafico.Per modificare lo stile di nodi e collegamenti, vedere Modificare lo stile di nodi e collegamenti.
Aprire il menu di scelta rapida dalla superficie del grafico.Scegliere Vai, DGML.
Visual Studio apre il file .dgml del grafico.
Nell'elemento <DirectedGraph> aggiungere uno qualsiasi dei seguenti attributi per modificarne lo stile:
Per modificare
Aggiungere il seguente attributo
Colore sfondo
Background="ColorNameOrHexadecimalValue"Colore bordo
Stroke="StrokeValue"Ad esempio:
<DirectedGraph Background="Green" xmlns="https://schemas.microsoft.com/vs/2009/dgml" > ... ... </DirectedGraph>
Modificare lo stile di nodi e collegamenti
È possibile modificare le icone e i colori di nodi e collegamenti.È possibile utilizzare colori e icone predefiniti o specificarne di personalizzati modificando il file con estensione dgml del grafico.Vedere Applicare stili personalizzati a nodi e collegamenti.
Ad esempio, è possibile scegliere un colore per evidenziare nodi e collegamenti con una determinata categoria o proprietà.In questo modo è possibile identificare aree specifiche del grafico e concentrarsi su di esse.
Per applicare un colore o un'icona predefinita ai nodi con una determinata categoria o proprietà
Se la casella LEGENDA non è visibile, aprire il menu di scelta rapida per il grafico.Scegliere Mostra legenda.
Nella casella Legenda verificare se la categoria o la proprietà del nodo è visualizzata nell'elenco.
Se l'elenco non include la categoria o la proprietà, scegliere + nella casella LEGENDA, Categoria nodo o Proprietà nodoe la categoria o la proprietà.
La categoria o la proprietà viene visualizzata nella casella LEGENDA.
[!NOTA]
Per creare e assegnare una categoria a un nodo, vedere Assegnare categorie a nodi e collegamenti.Per creare e assegnare una proprietà a un nodo, vedere Assegnare proprietà a nodi e collegamenti.
Nella casella Legenda aprire l'elenco a discesa accanto alla categoria o alla proprietà.
Utilizzare la tabella seguente per selezionare lo stile che si desidera modificare:
Per modificare
Choose
Colore sfondo
Background
Colore del contorno
Tratto
Colore del testo
Foreground
Icona
Icone
La casella Selezione set colori appare per selezionare un colore (o un'icona).
Nella casella di dialogo Selezione set colori scegliere una delle seguenti opzioni:
Per applicare un
Eseguire questi passaggi
Set di colori (o icone)
Aprire l'elenco Seleziona colore (o icona) imposta.Selezionare un set di colori (o icone).
Per ripristinare il colore predefinito (o l'icona predefinita), nell'elenco Seleziona set di colori (icone imposta ) fare clic su Nessuno.
Colore specifico (o un'icona specifica)
Aprire l'elenco di valore della proprietà o di categoria.Selezionare un colore (o un'icona).
[!NOTA]
È possibile ridisporre, eliminare o disattivare temporaneamente stili nella casella Legenda.Vedere Modificare la casella Legenda.
Per applicare un colore predefinito ai collegamenti con una determinata categoria o proprietà
Se la casella LEGENDA non è visibile, aprire il menu di scelta rapida per il grafico.Scegliere Mostra legenda.
Nella casella Legenda verificare se la categoria o la proprietà è visualizzata nell'elenco.
Se l'elenco non include la categoria o la proprietà, scegliere + nella casella LEGENDA, Categoria collegamento o Proprietà collegamentoe la categoria o la proprietà.
La categoria o la proprietà viene visualizzata nella casella LEGENDA.
[!NOTA]
Per creare e assegnare una categoria a un collegamento, vedere Assegnare categorie a nodi e collegamenti.Per creare e assegnare una proprietà a un collegamento, vedere Assegnare proprietà a nodi e collegamenti.
Nella casella LEGENDA, aprire l'elenco accanto alla categoria o la proprietà.
Selezionare tratto per modificare il colore di contorno e la punta della freccia del collegamento.
La casella Selezione set colori appare per selezionare un colore.
Nella casella Selezione set colori scegliere una delle seguenti opzioni:
Per applicare un
Eseguire questi passaggi
Set di colori
Aprire l'elenco Seleziona coloreimposta.Selezionare un set di colori.
Per ripristinare il colore predefinito, nell'elenco Seleziona set di colori, scegliere Nessuno.
Colore specifico
Aprire l'elenco di valore della proprietà o del tipo per selezionare un colore.
[!NOTA]
È possibile ridisporre, eliminare o disattivare temporaneamente stili nella casella Legenda.Vedere Modificare la casella Legenda.
.gif "Ee842619.collapse_all(it-it,VS.110).gif")
Applicare stili personalizzati a nodi e collegamenti
È possibile applicare stili personalizzati agli elementi seguenti:
Singoli nodi e collegamenti
Gruppi di nodi e collegamenti
Gruppi di nodi e collegamenti in base a determinate condizioni
Per applicare uno stile personalizzato a un singolo nodo
Aprire il menu di scelta rapida del nodo di cui si desidera personalizzare lo stile.Scegliere Vai, DGML.
Visual Studio apre il file con estensione dgml del grafico e viene evidenziato l'elemento <Node/> relativo a tale nodo.
Nell'elemento <Node/> aggiungere uno qualsiasi dei seguenti attributi per personalizzarne lo stile:
Per modificare
Aggiungere il seguente attributo
Colore sfondo
Background="ColorNameOrHexadecimalValue"Contorno
Stroke="ColorNameOrHexadecimalValue"Spessore del contorno
StrokeThickness="StrokeValue"Colore del testo
Foreground="ColorNameOrHexadecimalValue"Icona
Icon="IconFilePathLocation"Dimensione del testo
FontSize="FontSizeValue"Tipo di testo
FontFamily="FontFamilyName"Spessore del testo
FontWeight="FontWeightValue"Stile del testo
FontStyle="FontStyleName"È possibile, ad esempio, specificare Italic come stile del testo.
Trama
Style="Glass"- oppure -
Style="Plain"Forma
Per sostituire una forma con un'icona, impostare la proprietà Shape a None e impostare la proprietà Icon al percorso del file con l'icona.
Shape="ShapeFilePathLocation"Ad esempio:
<Nodes> <Node Id="MyNode" Background="#FF008000" Stroke="#FF000000" Foreground="#FFFFFFFF" Icon="...\Icons\Globe.png"/> </Nodes>
Per applicare uno stile personalizzato a un singolo collegamento
Nel grafico, spostare il puntatore del mouse sul collegamento.Viene visualizzata una descrizione comando che identifica il nodo di origine e il nodo di destinazione del collegamento.(Tastiera: premereTab fino a quando non è attivo il collegamento.)
Aprire il menu di scelta rapida per il grafico.Scegliere Vai, DGML.
Visual Studio apre il file .dgml del grafico.
Trovare l'elemento <Link/> che contiene i nomi del nodo di origine e del nodo di destinazione.
Nell'elemento <Link/> aggiungere uno qualsiasi dei seguenti attributi per personalizzarne lo stile:
Per modificare
Aggiungere il seguente attributo
Colore di contorno e punta della freccia
Stroke="ColorNameOrHexadecimalValue"Spessore del contorno
StrokeThickness="StrokeValue"Stile del contorno
StrokeDashArray="StrokeArrayValues"Ad esempio:
<Links> <Link Source="MyFirstNode" Target="MySecondNode" Background="Green" Stroke="#FF000000" StrokeDashArray="2,2"/> </Links>
Per applicare stili personalizzati a un gruppo di nodi o collegamenti
Assegnare qualsiasi categoria o proprietà desiderata ai nodi o ai collegamenti.
.gif "Suggerimento")
SuggerimentoSe si dispone di stili ripetuti in molti nodi o collegamenti, è possibile applicare una categoria ai nodi o collegamenti e applicare poi uno stile alla categoria.Per ulteriori informazioni, vedere Assegnare categorie a nodi e collegamenti e Assegnare proprietà a nodi e collegamenti.
Aprire il menu di scelta rapida per la superficie del grafico.Scegliere Vai, DGML.
Visual Studio apre il file .dgml del grafico.
Se non è presente un elemento <Styles></Styles>, aggiungerne uno sotto l'elemento <DirectedGraph></DirectedGraph> dopo l'elemento <Links></Links>.
Nell'elemento <Styles></Styles>, sotto l'elemento <Style/>, specificare gli attributi seguenti:
TargetType="Node | Link | Graph"
GroupLabel="NameInLegendBox"
ValueLabel="NameInStylePickerBox"
Per applicare un stile personalizzato a tutti i tipi di destinazione, non utilizzare una condizione.
Per applicare uno stile condizionale a gruppi di nodi o di collegamenti
Nell'elemento <Style/> aggiungere un elemento <Condition/> contenente un attributo Expression per specificare un'espressione che restituisca un valore booleano.
Ad esempio:
<Condition Expression="MyCategory"/>- oppure -
<Condition Expression="MyCategory > 100"/>- oppure -
<Condition Expression="HasCategory('MyCategory')"/>Questa espressione utilizza la sintassi BNF(Backus-Naur Form) seguente:
<Expression> ::= <BinaryExpression> | <UnaryExpression> | "("<Expression>")" | <MemberBindings> | <Literal> | <Number>
<BinaryExpression> ::= <Expression> <Operator> <Expression>
<UnaryExpression> ::= "!" <Expression> | "+" <Expression> | "-" <Expression>
<Operator> ::= "<" | "<=" | "=" | ">=" | ">" | "!=" | "or" | "and" | "+" | "*" | "/" | "-"
<MemberBindings> ::= <MemberBindings> | <MemberBinding> "." < MemberBinding >
<MemberBinding> ::= <MethodCall> | <PropertyGet>
<MethodCall> ::= <Identifier> "(" <MethodArgs> ")"
<PropertyGet> ::= Identifier
<MethodArgs> ::= <Expression> | <Expression> "," <MethodArgs> | <empty>
<Identifier> ::= [^.]*
<Literal> ::= valore letterale stringa tra virgolette singole o doppie
<Number> ::= stringa di cifre con virgola decimale facoltativa
È possibile specificare più elementi di <Condition/>, che devono essere tutti true lo stile.
Sulla riga successiva, dopo l'elemento <Condition/>, aggiungere uno o più elementi <Setter/> per specificare un attributo Property e un attributo fisso Value o un attributo calcolato Expression da applicare al grafico, ai nodi o ai collegamenti che soddisfano la condizione.
Ad esempio:
<Setter Property="BackGround" Value="Green"/>
Per fare un semplice esempio completo, la condizione seguente specifica che un nodo viene visualizzato in verde o in rosso a seconda che la categoria Passed sia impostata su True o su False:
<?xml version="1.0" encoding="utf-8"?>
<DirectedGraph xmlns="https://schemas.microsoft.com/vs/2009/dgml">
<Nodes>
<Node Id="MyFirstNode" Passed="True" />
<Node Id="MySecondNode" Passed="False" />
</Nodes>
<Links>
</Links>
<Styles>
<Style TargetType="Node" GroupLabel="Passed" ValueLabel="True">
<Condition Expression="Passed='True'"/>
<Setter Property="Background" Value="Green"/>
</Style>
<Style TargetType="Node" GroupLabel="Passed" ValueLabel="False">
<Condition Expression="Passed='False'"/>
<Setter Property="Background" Value="Red"/>
</Style>
</Styles>
</DirectedGraph>
Nella tabella seguente sono incluse alcune condizioni di esempio che è possibile utilizzare:
Modificare la casella Legenda
È possibile ridisporre, eliminare o disattivare temporaneamente stili nella casella Legenda:
Aprire il menu di scelta rapida per uno stile nella casella LEGENDA.
Effettuare una delle attività seguenti:
Per
Choose
Spostare lo stile in alto
Sposta su
Spostare l'elemento in basso
Sposta giù
Eliminare l'elemento
Eliminare
Disattivare l'elemento
Disabilita
Riattivare l'elemento
Abilita
Copiare stili da un grafico a un altro
Assicurarsi che la casella LEGENDA venga visualizzata nel grafico di origine.Se non è visibile, aprire il menu di scelta rapida per un'area vuota del grafico di origine.Scegliere Mostra legenda.
Aprire il menu di scelta rapida per la casella LEGENDA.Scegliere Copia legenda.
Incollare la legenda sul grafico di destinazione.
Assegnare proprietà a nodi e collegamenti
È possibile organizzare nodi e collegamenti mediante l'assegnazione di proprietà.Ad esempio, è possibile selezionare nodi con proprietà specifiche in modo che sia possibile raggrupparli, modificarne lo stile o nasconderli.
Per assegnare una proprietà a un nodo
Aprire il menu di scelta rapida del nodo.Scegliere Vai, DGML.
Visual Studio apre il file con estensione dgml del grafico e viene evidenziato l'elemento <Node/> relativo a tale nodo.
Nell'elemento <Node/> specificare il nome della proprietà e il relativo valore.Ad esempio:
<Nodes> <Node Id="MyNode" MyPropertyName="PropertyValue" /> </Nodes>Aggiungere un elemento <Property/> alla sezione <Properties> per specificare attributi quali il nome visibile e il tipo di dati:
<Properties> <Property Id="MyPropertyName" Label="My Property" DataType="System.DataType"/> </Properties>
Per assegnare una proprietà a un collegamento
Nel grafico, spostare il puntatore del mouse sul collegamento.Viene visualizzata una descrizione comando che identifica il nodo di origine e il nodo di destinazione del collegamento.(Tastiera: Premere TAB finché lo stato attivo non sia sul collegamento.)
Aprire il menu di scelta rapida per il grafico.Scegliere Vai, DGML.
Visual Studio apre il file .dgml del grafico.
Trovare l'elemento <Link/> che contiene i nomi del nodo di origine e del nodo di destinazione.
Nell'elemento <Node/> specificare il nome della proprietà e il relativo valore.Ad esempio:
<Links> <Link Source="MyFirstNode" Target="MySecondNode" MyPropertyName="PropertyValue" /> </Links>Aggiungere un elemento <Property/> alla sezione <Properties> per specificare attributi quali il nome visibile e il tipo di dati:
<Properties> <Property Id="MyPropertyName" Label="My Property Name" DataType="System.DataType"/> </Properties>
Assegnare categorie a nodi e collegamenti
È possibile organizzare nodi mediante l'assegnazione di categorie.Ad esempio, è possibile selezionare nodi appartenenti a determinate categorie in modo che sia possibile raggrupparli, modificarne lo stile o nasconderli.È possibile evidenziare collegamenti con determinate categorie.Per ulteriori informazioni, vedere le sezioni che seguono:
Raggruppare nodi
Modificare lo stile di nodi e collegamenti
Nascondere o mostrare nodi
Per assegnare una categoria a un nodo
- Per assegnare una categoria predefinita, come Categoria 1, aprire il menu di scelta rapida del nodo.Scegliere Categorizza e una categoria predefinita.
- oppure -
Per creare e assegnare una categoria personalizzata:
- Selezionare il nodo che si desidera suddividere in categorie.Premere F4 per aprire la finestra Proprietà.Digitare il nome della categoria nella proprietà Nuova categoria del nodo.Premere INVIO.
- oppure -
Aprire il menu di scelta rapida del nodo.Scegliere Vai, DGML.
Visual Studio apre il file con estensione dgml del grafico e viene evidenziato l'elemento <Node/> relativo a tale nodo.
Nell'elemento <Node/> aggiungere un attributo Category per specificare il nome della categoria.Ad esempio:
<Nodes> <Node Id="MyNode" Category="MyCategory" /> </Nodes>Aggiungere un elemento <Category/> alla sezione <Categories> in modo che sia possibile utilizzare l'attributo Label per specificare il testo visualizzato per tale categoria:
<Categories> <Category Id="MyCategory" Label="My Category" /> </Categories>
Per assegnare una categoria a un collegamento
Nel grafico spostare il puntatore del mouse sul collegamento per visualizzare la descrizione comando e identificare il nodo di origine e il nodo di destinazione del collegamento.(Tastiera: Premere TAB finché lo stato attivo non sia sul collegamento.)
Aprire il menu di scelta rapida per il grafico.Scegliere Vai, DGML.
Visual Studio apre il file .dgml del grafico.
Trovare l'elemento <Link/> che contiene i nomi del nodo di origine e del nodo di destinazione.
Nell'elemento <Link/> aggiungere un attributo Category per specificare il nome della categoria.Ad esempio:
<Links> <Link Source="MyFirstNode" Target="MySecondNode" Category="MyCategory" </Links>Aggiungere un elemento <Category/> alla sezione <Categories> in modo che sia possibile utilizzare l'attributo Label per specificare il testo visualizzato per tale categoria:
<Categories> <Category Id="MyCategory" Label="My Category" /> </Categories>
È possibile creare categorie gerarchiche per facilitare l'organizzazione di nodi e aggiungere attributi alle categorie figlio tramite l'ereditarietà.
Per creare categorie gerarchiche
Aggiungere un elemento <Category/> per la categoria padre, quindi aggiungere l'attributo BasedOn all'elemento <Category/> della categoria figlio.
Ad esempio:
<Nodes> <Node Id="MyFirstNode" Label="My First Node" Category= "MyCategory" /> <Node Id="MySecondNode" Label="My Second Node" /> </Nodes> <Links> <Link Source="MyFirstNode" Target="MySecondNode" /> </Links> <Categories> <Category Id="MyCategory" Label="My Category" BasedOn="MyParentCategory"/> <Category Id="MyParentCategory" Label="My Parent Category" Background="Green"/> </Categories>In questo esempio lo sfondo di MyFirstNode è verde perché il relativo attributo Category eredita l'attributo Background di MyParentCategory.
Collegare elementi ai nodi o ai collegamenti
È possibile collegare gli elementi, quali i documenti o URL, a un nodo o un collegamento modificando il file .dgml del grafico e aggiungendo un attributo Reference all'elemento <Node/> per un nodo o elemento <Link/> per un collegamento.È quindi possibile aprire e visualizzare il contenuto dal nodo o dal collegamento del grafico.L'attributo Reference specifica il percorso di tale contenuto.Il percorso può essere assoluto oppure relativo alla posizione del file con estensione dgml.
| Attenzione |
|---|
Se si utilizzano percorsi relativi, e il file con estensione .dgml viene spostato in un percorso diverso, i percorsi non saranno più risolvibili.Quando si tenta di aprire e visualizzare il contenuto collegato, si verificherà un errore che informa che il contenuto non può essere visualizzato. |
Ad esempio, è possibile collegare i seguenti elementi:
Per descrivere le modifiche apportate a una classe, è possibile collegare l'URL di un elemento di lavoro, un documento o un altro file con estensione dgml al nodo relativo a una classe.
È possibile collegare un diagramma livello a un nodo di gruppo che rappresenta un livello nell'architettura logica del software.
Per visualizzare ulteriori informazioni su un componente che espone un'interfaccia, è possibile associare un diagramma componente al nodo relativo a tale interfaccia.
Collegare un nodo a un elemento di lavoro o un bug di Team Foundation Server o ad altre informazioni correlate al nodo.
Per collegare un elemento a un nodo
Nel grafico, aprire il menu di scelta rapida del nodo.Scegliere Vai, DGML.
Visual Studio apre il file con estensione dgml del grafico e viene evidenziato l'elemento <Node/> relativo a tale nodo.
Eseguire una delle attività elencate nella tabella seguente:
Per collegare
Eseguire questi passaggi
Un singolo elemento
Nell'elemento <Node/> o <Link/> aggiungere un attributo Reference per specificare la posizione dell'elemento.
Nota
È possibile specificare un solo attributo Reference per ogni elemento .
Ad esempio:
<Nodes> <Node Id="MyNode" Reference="MyDocument.txt" /> </Nodes> <Properties> <Property Id="Reference" Label="My Document" DataType="System.String" IsReference="True" /> </Properties>Più elementi
Nell'elemento <Node/> o <Link/> aggiungere un nuovo attributo per specificare la posizione di ogni riferimento.
Nella sezione <Properties>:
Aggiungere un elemento <Property/> per ogni nuovo tipo di riferimento.
Impostare l'attributo Id sul nome dell'attributo del nuovo riferimento.
Aggiungere l'attributo IsReference e impostarlo su True affinché il riferimento venga visualizzato nel menu di scelta rapida Vai del nodo.
Utilizzare l'attributo Label per specificare il testo visualizzato nel menu di scelta rapida Vai del nodo.
Ad esempio:
<Nodes> <Node Id="MyNode" SequenceDiagram="MySequenceDiagram.sequencediagram" ActiveBugs="MyActiveBugs.wiq"/> </Nodes> <Properties> <Property Id="SequenceDiagram" Label="My Sequence Diagram" DataType="System.String" IsReference="True" /> <Property Id="ActiveBugs" Label="Active Bugs" DataType="System.String" IsReference="True" /> </Properties>Nel grafico il nome del nodo viene visualizzato sottolineato.Quando si apre il menu di scelta rapida del nodo o il collegamento, verrà visualizzato un menu di scelta rapida Vai che contiene gli elementi collegati da scegliere.
Utilizzare l'attributo ReferenceTemplate per specificare una stringa comune, ad esempio un URL, utilizzata da più riferimenti anziché ripetere tale stringa nel riferimento.
L'attributo ReferenceTemplate specifica un segnaposto per il valore del riferimento.Nell'esempio seguente il segnaposto {0} nell'attributo ReferenceTemplate verrà sostituito dai valori degli attributi MyFirstReference e MySecondReference nell'elemento <Node/> per produrre un percorso completo:
<Nodes> <Node Id="MyNode" MyFirstReference="MyFirstDocument" MySecondReference="MySecondDocument"/> <Node Id="MySecondNode" MyFirstReference="AnotherFirstDocument" MySecondReference="AnotherSecondDocument"/> </Nodes> <Properties> <Property Id="MyFirstReference" Label="My First Document" DataType="System.String" IsReference="True" ReferenceTemplate="http://www.Fabrikam.com/FirstDocuments/{0}.asp"/> <Property Id="MySecondReference" Label="My Second Document" DataType="System.String" IsReference="True" ReferenceTemplate=" http://www.Fabrikam.com/SecondDocuments/{0}.asp"/> </Properties>Per visualizzare l'elemento o gli elementi a cui si fa riferimento nel grafico, scegliere dal menu di scelta rapida del nodo o il collegamento.Scegliere Vai a e quindi l'elemento.
Creare alias per percorsi di utilizzo comune
Sostituendo i percorsi di utilizzo comune con alias è possibile ridurre le dimensioni del file con estensione dgml e il tempo necessario per caricare o salvare il file.Per creare un alias, aggiungere una sezione <Paths></Paths> alla fine del file con estensione dgml.In questa sezione aggiungere un elemento <Path/> per definire un alias per il percorso:
<Paths>
<Path Id="MyPathAlias" Value="C:\...\..." />
</Paths>
Per fare riferimento all'alias da un elemento nel file con estensione dgml, racchiudere il valore Id dell'elemento <Path/> con un segno di dollaro ($) e parentesi (()):
<Nodes>
<Node Id="MyNode" Reference="$(MyPathAlias)MyDocument.txt" />
</Nodes>
<Properties>
<Property Id="Reference" Label="My Document" DataType="System.String" IsReference="True" />
</Properties>
Informazioni su DGML (Directed Graph Markup Language)
DGML utilizza semplice codice XML per descrivere grafici diretti ciclici e aciclici.Un grafico diretto è un set di nodi connessi da collegamenti o bordi.I nodi e i collegamenti possono essere utilizzati per rappresentare strutture di rete, ad esempio elementi in un progetto software.Utilizzare DGML per visualizzare informazioni, eseguire analisi di complessità o semplicemente esplorare e modificare grafici diretti.
I nodi e i collegamenti sono detti elementi del grafico o semplicemente elementi.Nella tabella seguente sono descritti i tipi di elementi utilizzati in DGML:
[!NOTA]
Quando si modifica un file con estensione dgml, IntelliSense consente di identificare gli attributi disponibili per ogni elemento e i relativi valori.Per specificare il colore in un attributo, utilizzare nomi dei colori comuni, come "Blue", o valori ARGB esadecimali, come "#ffa0b1c3."In DGML viene utilizzato un piccolo subset di formati di definizione dei colori WPF (Windows Presentation Foundation).Per ulteriori informazioni, vedere Classe Colors.
Elemento |
Formato di esempio |
|---|---|
<DirectedGraph></DirectedGraph> Questo elemento è l'elemento radice di un documento grafico diretto, con estensione dgml.Tutti gli altri elementi DGML sono inclusi nell'ambito di questo elemento. Nell'elenco seguente vengono descritti gli attributi facoltativi che è possibile includere:
|
|
<Nodes></Nodes> Questo elemento facoltativo contiene un elenco di elementi <Node/> che definiscono i nodi nel grafico.Per ulteriori informazioni, vedere l'elemento <Node/>. Nota
Quando si fa riferimento a un nodo non definito in un elemento <Link/>, il grafico crea automaticamente un elemento <Node/>.
|
|
<Node/> Questo elemento definisce un singolo nodo.Esso viene visualizzato nell'elenco di elementi <Nodes><Nodes/>. L'elemento deve includere gli attributi seguenti:
Nell'elenco seguente vengono descritti alcuni degli attributi facoltativi che è possibile includere:
|
|
<Links></Links> Questo elemento contiene l'elenco di elementi <Link> che definiscono i collegamenti tra i nodi.Per ulteriori informazioni, vedere l'elemento <Link/>. |
|
<Link/> Questo elemento definisce un singolo collegamento che connette un nodo di origine a un nodo di destinazione.Esso viene visualizzato nell'elenco di elementi <Links></Links>. Nota
Se questo elemento fa riferimento a un nodo non definito, il documento grafico crea automaticamente un nodo con gli attributi specificati, se presenti.
L'elemento deve includere gli attributi seguenti:
Nell'elenco seguente vengono descritti alcuni degli attributi facoltativi che è possibile includere:
|
|
<Categories></Categories> Questo elemento contiene l'elenco di elementi <Category/>.Per ulteriori informazioni, vedere l'elemento <Category/>. |
|
<Category/> Questo elemento definisce un attributo Category, utilizzato per identificare gli elementi che condividono questo attributo.Un attributo Category può essere utilizzato per organizzare gli elementi del grafico, fornire attributi condivisi tramite ereditarietà o definire metadati aggiuntivi. L'elemento deve includere gli attributi seguenti:
Nell'elenco seguente vengono descritti alcuni degli attributi facoltativi che è possibile includere:
Le categorie forniscono inoltre il comportamento di base dei modelli che controlla l'aspetto di nodi e collegamenti quando vengono visualizzati in un grafico.Vedere Applicare stili personalizzati a nodi e collegamenti. |
|
<Properties></Properties> Questo elemento contiene l'elenco di elementi <Property/>.Per ulteriori informazioni, vedere l'elemento <Property/>. |
|
<Property/> Questo elemento definisce un attributo Property che è possibile utilizzare per assegnare un valore a qualsiasi attributo o elemento DGML, incluse categorie e altre proprietà. L'elemento deve includere gli attributi seguenti:
Se si desidera che la proprietà venga visualizzata nella finestra Proprietà, utilizzare la proprietà Label per specificare il nome visualizzato della proprietà. Vedere Assegnare proprietà a nodi e collegamenti. |
|