Creare diagrammi livello dal codice

Per visualizzare il livello elevato del sistema software, ovvero l'architettura logica, creare un diagramma livello in Visual Studio Ultimate. Per assicurarsi che il codice rimanga coerente con la progettazione, convalidare il codice con un diagramma livello in Visual Studio Ultimate o Visual Studio Premium. È possibile creare diagrammi livello per i progetti Visual C# .NET e Visual Basic. .NET.

Scegliere l'argomento con cui si desidera procedere

• Ulteriori informazioni sui diagrammi livello

• Creare un diagramma livello

• Creare livelli da elementi

• Gestire collegamenti tra livelli ed elementi

• Decompilare dipendenze esistenti

• Modificare livelli e dipendenze per visualizzare la progettazione desiderata

• Modificare la modalità di visualizzazione degli elementi nel diagramma

Ulteriori informazioni sui diagrammi livello

Un diagramma livello consente di organizzare gli elementi della soluzione Visual Studio in gruppi logici e astratti denominati livelli. È possibile utilizzare i livelli per descrivere le attività principali che tali elementi eseguono oppure i componenti principali del sistema. Ogni livello può contenere altri livelli che descrivono attività più dettagliate. È possibile inoltre specificare le dipendenze desiderate o esistenti tra i livelli. Tali dipendenze, rappresentate come frecce, mostrano quali livelli possono utilizzare o utilizzano attualmente la funzionalità rappresentata da altri livelli. Per gestire controllo a livello di architettura nel codice, mostrare le dipendenze desiderate nel diagramma, quindi convalidare il codice in base al diagramma.

Vedere:

• Video di Channel 9: Progettare e convalidare l'architettura utilizzando i diagrammi livello

• Diagrammi livello: riferimento

• Diagrammi livello: linee guida

• Convalidare il codice con diagrammi livello

• Sito Web di modelli e procedure dettagliate

Suggerimento

Quando si crea un diagramma livello, è possibile creare grafici di dipendenze per esplorare e comprendere il codice più facilmente.Tali grafici consentono di individuare cluster, modelli, livelli naturale e dipendenze nel codice.In tal modo sarà più semplice assegnare elementi ai livelli.È inoltre possibile utilizzare Esplora architettura per esplorare spazi dei nomi e classi, che spesso corrispondono correttamente ai livelli esistenti.È quindi possibile utilizzare diagrammi livello per aggiornare il codice.

Vedere:

• Mappare le dipendenze nel codice su grafici di dipendenze

• Trovare codice con Esplora architettura

Creare un diagramma livello

Prima di creare un diagramma livello, verificare che alla soluzione sia associato un progetto di modello. Vedere Creare diagrammi e progetti di modello UML.

Importante

Non aggiungere, trascinare o copiare alcun diagramma livello esistente da un progetto di modello a un altro né a un altro percorso nella soluzione.In questo modo i riferimenti del diagramma originale verranno mantenuti, anche se si modifica il diagramma.In caso contrario, il funzionamento della convalida dei livelli non sarà corretto e potrebbero verificarsi altri problemi, quali la mancanza di elementi o altri errori quando si tenta di aprire il diagramma.

È necessario aggiungere invece un nuovo diagramma livello al progetto di modello,copiare gli elementi dal diagramma di origine al nuovo diagrammae salvare sia il progetto di modello che il nuovo diagramma livello.

Per aggiungere un nuovo diagramma livello a un progetto di modello

1. Scegliere Nuovo diagramma dal menu Architettura.

2. In Modelli scegliere Diagramma livello.

3. Assegnare un nome al diagramma.

4. In Aggiungi a progetto di modello individuare e selezionare un progetto di modello esistente nella soluzione.

   - oppure -

   Selezionare Crea nuovo progetto di modello per aggiungere un nuovo progetto di modello alla soluzione.

   Nota

   È necessario che il diagramma livello sia presente all'interno di un progetto di modello.È tuttavia possibile collegarlo a elementi in qualsiasi punto della soluzione.

5. Assicurarsi di salvare il progetto di modello contenente il diagramma livello.

Creare livelli da elementi

È possibile creare livelli da elementi presenti in una soluzione di Visual Studio, ad esempio progetti, file di codice, spazi dei nomi, classi e metodi. In questo modo vengono creati automaticamente collegamenti tra livelli ed elementi, che vengono inclusi nel processo di convalida dei livelli.

È inoltre possibile collegare livelli a elementi che non supportano la convalida, ad esempio documenti Word o presentazioni PowerPoint, in modo da associare un livello con specifiche o piani. È anche possibile collegare livelli a file di progetti condivisi tra più applicazioni, ma il processo di convalida non includerà tali livelli, che vengano visualizzati con nomi generici come "Livello 1" e "Livello 2".

Per verificare se un elemento collegato supporta la convalida, aprire Esplora livello ed esaminare la proprietà Convalida supporti dell'elemento. Vedere Gestione di collegamenti a elementi.

Per	Si seguano le seguenti istruzioni
Creare un livello per un solo elemento	Trascinare l'elemento nel diagramma livello da una qualsiasi delle origini seguenti: Esplora soluzioni Ad esempio, è possibile trascinare file o progetti. Esplora architettura È possibile ad esempio trascinare file binari, assembly, spazi dei nomi, classi o metodi. Vedere Trovare codice con Esplora architettura. Grafici delle dipendenze Vedere Mappare le dipendenze nel codice su grafici di dipendenze. Nel diagramma viene visualizzato un livello collegato all'elemento. Rinominare il livello per riflettere le responsabilità del codice o degli elementi associati. Importante Se si trascinano file binari sul diagramma livello, i riferimenti relativi non vengono aggiunti automaticamente al progetto di modello,ma è necessario aggiungere manualmente i file binari desiderati per convalidare il progetto di modello. Per aggiungere file binari al progetto di modello In Esplora soluzioni aprire il menu di scelta rapida del progetto di modello, quindi scegliere Aggiungi elemento esistente. Nella finestra di dialogo Aggiungi elemento esistente individuare i file binari, selezionarli, quindi scegliere OK. I file binari verranno visualizzati nel progetto di modello. In Esplora soluzioni scegliere un file binario aggiunto, quindi premere F4 per aprire la finestra Proprietà. Per ogni file binario, impostare la proprietà Operazione di compilazione su Convalida.
Creare un solo livello per tutti gli elementi selezionati	Trascinare contemporaneamente tutti gli elementi sul diagramma livello. Nel diagramma viene visualizzato un livello collegato a tutti gli elementi.
Creare un livello per ogni elemento selezionato	Premere e tenere premuto MAIUSC mentre si trascinano contemporaneamente tutti gli elementi nel diagramma livello. Nota Se si utilizza MAIUSC per selezionare un intervallo di elementi, rilasciare il tasto dopo avere selezionato gli elementi.Premerlo e tenerlo premuto nuovamente quando si trascinano gli elementi nel diagramma. Per ogni elemento nel diagramma viene visualizzato un livello collegato a ciascun elemento.
Aggiungere un elemento a un livello	Trascinare l'elemento sul livello.
Creare un nuovo livello non collegato	In Casella degli strumenti espandere la sezione Diagramma livello, quindi trascinare un Livello nel diagramma livello. Per aggiungere più livelli, fare doppio clic sullo strumento. Una volta completata l'operazione, scegliere lo strumento Puntatore o premere ESC. oppure Aprire il menu di scelta rapida del diagramma livello, scegliere Aggiungi, quindi scegliere Livello.
Creare livelli annidati	Trascinare un livello esistente su un altro livello. oppure Aprire il menu di scelta rapida di un diagramma livello, scegliere Aggiungi quindi scegliere Livello.
Creare un nuovo livello contenente due o più livelli esistenti	Selezionare i livelli, aprire il menu di scelta rapida per la selezione, quindi scegliere Gruppo.
Modificare il colore di un livello	Impostare la proprietà Colore sul colore desiderato.
Specificare che gli elementi associati a un livello non devono appartenere agli spazi dei nomi specificati	Digitare gli spazi dei nomi nella proprietà Forbidden Namespaces del livello. Utilizzare un punto e virgola (;) per separare gli spazi dei nomi.
Specificare che gli elementi associati a un livello non possono dipendere dagli spazi dei nomi specificati	Digitare gli spazi dei nomi nella proprietà Forbidden Namespace Dependencies del livello. Utilizzare un punto e virgola (;) per separare gli spazi dei nomi.
Specificare che gli elementi associati a un livello non devono appartenere a uno degli spazi dei nomi specificati	Digitare lo spazio dei nomi nella proprietà Required Namespaces del livello. Utilizzare un punto e virgola (;) per separare gli spazi dei nomi.

Il numero raffigurato sul livello indica il numero di elementi a esso collegati. Tuttavia, nell'interpretazione di tale numero, considerare quanto segue:

• Se un livello è collegato a un elemento contenente altri elementi, ma non è collegato direttamente ad altri elementi, il numero include solo l'elemento collegato. Tuttavia, gli altri elementi vengono inclusi per l'analisi durante la convalida dei livelli.

  Ad esempio, se un livello è collegato a un solo spazio dei nomi, il numero degli elementi collegati sarà 1, anche se lo spazio dei nomi contiene classi. Se il livello è collegato anche a ciascuna classe dello spazio dei nomi, il numero includerà le classi collegate.

• Se un livello contiene altri livelli collegati a elementi, anche il livello contenitore sarà collegato a tali elementi nonostante il numero raffigurato sul livello contenitore non includa quegli elementi.

Gestire collegamenti tra livelli ed elementi

1. Nel diagramma livello aprire il menu di scelta rapida per il livello, quindi scegliere Visualizza collegamenti.

   In Esplora livello vengono visualizzati i collegamenti dell'elemento per il livello selezionato.

2. Utilizzare le seguenti attività per gestire tali collegamenti:

Per	In Esplora livello
Eliminare il collegamento tra il livello e un elemento	Aprire il menu di scelta rapida per il collegamento all'elemento, quindi scegliere Elimina.
Spostare il collegamento da un livello a un altro	Trascinare il collegamento dell'elemento in un livello esistente del diagramma. oppure Aprire il menu di scelta rapida per il collegamento all'elemento, quindi scegliere Taglia. Nel diagramma livello aprire il menu di scelta rapida per il livello, quindi scegliere Incolla.
Copiare il collegamento da un livello a un altro	Aprire il menu di scelta rapida per il collegamento all'elemento, quindi scegliere Copia. Nel diagramma livello aprire il menu di scelta rapida per il livello, quindi scegliere Incolla.
Creare un nuovo livello da un collegamento dell'elemento esistente	Trascinare il collegamento dell'elemento in un'area vuota del diagramma.
Verificare che un elemento collegato supporti la convalida in base al diagramma livello.	Cercare il collegamento dell'elemento nella colonna Convalida supporti.

Decompilare dipendenze esistenti

È presente una dipendenza quando un elemento associato a un livello dispone di un riferimento a un elemento associato a un altro livello. Ad esempio, una classe di un livello dichiara una variabile che dispone di una classe in un altro livello. È possibile decompilare dipendenze esistenti per elementi collegati a livelli nel diagramma.

Nota

Non è possibile decompilare dipendenze per determinati tipi di elementi.Ad esempio, non è possibile decompilare dipendenze da e verso un livello collegato a un file di testo.Per verificare a quali elementi sono associate dipendenze che è possibile decompilare, aprire il menu di scelta rapida di uno o più livelli, quindi scegliere Visualizza collegamenti.In Esplora livello esaminare la colonna Supporta la convalida.Le dipendenze non verranno decompilate per elementi per i quali in questa colonna è indicato False.

• Selezionare uno o più livelli, aprire il menu di scelta rapida per un livello, quindi scegliere Genera dipendenze.

In genere vengono visualizzate alcune dipendenze che non dovrebbero esistere. È possibile modificare queste dipendenze per allinearle con la progettazione desiderata.

Modificare livelli e dipendenze per visualizzare la progettazione desiderata

Per descrivere le modifiche da apportare al sistema o all'architettura desiderata, modificare il diagramma livello:

Per	Eseguire questi passaggi
Modificare o limitare la direzione di una dipendenza	Impostare la proprietà Direzione.
Creare nuove dipendenze	Utilizzare gli strumenti Dipendenza e Dipendenza bidirezionale. Per disegnare più dipendenze, fare doppio clic sullo strumento. Una volta completata l'operazione, scegliere lo strumento Puntatore o premere ESC.
Specificare che gli elementi associati a un livello non possono dipendere dagli spazi dei nomi specificati	Digitare gli spazi dei nomi nella proprietà Forbidden Namespace Dependencies del livello. Utilizzare un punto e virgola (;) per separare gli spazi dei nomi.
Specificare che gli elementi associati a un livello non devono appartenere agli spazi dei nomi specificati	Digitare gli spazi dei nomi nella proprietà Forbidden Namespaces del livello. Utilizzare un punto e virgola (;) per separare gli spazi dei nomi.
Specificare che gli elementi associati a un livello non devono appartenere a uno degli spazi dei nomi specificati	Digitare lo spazio dei nomi nella proprietà Required Namespaces del livello. Utilizzare un punto e virgola (;) per separare gli spazi dei nomi.

Modificare la modalità di visualizzazione degli elementi nel diagramma

È possibile modificare la dimensione, la forma, il colore e la posizione dei livelli o il colore delle dipendenze modificandone le proprietà.

Vedere anche

Concetti

Visualizzare codice