Procedura: trovare codice tramite Esplora architettura

In Visual Studio Ultimate è possibile selezionare sezioni verticali di codice che si desidera visualizzare utilizzando Esplora architettura. È possibile esplorare il codice sorgente in una soluzione di Visual Studio o il codice compilato. È possibile utilizzare Esplora architettura per esplorare altri domini installando provider aggiuntivi. Quando si trova il codice che si desidera visualizzare, è possibile generare grafici per esplorare le relazioni presenti in tale codice. Per ulteriori informazioni, vedere Procedura: generare grafici di dipendenze per il codice .NET.

In questo argomento

• Informazioni su Esplora architettura

• Trovare codice sorgente in una soluzione di Visual Studio.

• Trovare codice compilato in un assembly gestito o in file eseguibili.

• Perfezionare i risultati dell'esplorazione.

• Aggiornare i risultati dell'esplorazione.

È possibile salvare la sessione di esplorazione come query (file con estensione dgql), in modo da poterla riutilizzare in un secondo momento:

• Salvare la sessione di esplorazione come query.

• Trovare query salvate.

Informazioni su Esplora architettura

Per aprire Esplora architettura

• Scegliere Finestre dal menu Architettura, quindi fare clic su Esplora architettura.

  Per ridimensionare Esplora architettura, trascinare la parte superiore della finestra fino all'altezza desiderata. Per spostare Esplora architettura, trascinare la barra del titolo o la scheda nella posizione desiderata.

  Nota

  Se sopra Esplora architettura viene visualizzata una finestra qualsiasi, ad esempio la finestra Elenco errori o la finestra Output, spostarla in modo che non impedisca il ridimensionamento di Esplora architettura.

Esplora architettura: domini, visualizzazioni, nodi, tipi di nodo e tipi di collegamento

Esplora architettura rappresenta strutture come nodi e relazioni come collegamenti. Durante l'esplorazione, in Esplora architettura vengono visualizzati nodi in colonne successive. Nella prima colonna sono presenti i domini e le visualizzazioni che è possibile esplorare. Quando si selezionano un dominio e una visualizzazione, in Esplora architettura vengono mostrati i nodi disponibili in tale visualizzazione.

Quando si selezionano nodi in una colonna, nella colonna successiva in Esplora architettura vengono mostrati i nodi correlati alla selezione in modo logico. Ad esempio, se si selezionano spazi dei nomi, nella colonna successiva saranno visualizzati tipi. Se si selezionano tipi, nella colonna successiva saranno visualizzati membri. La colonna dell'azione compressa visualizzata lungo il lato destro di una colonna del nodo identifica i tipi o le relazioni predefinite dei nodi contenuti nella colonna successiva. È possibile filtrare i risultati della colonna successiva espandendo la colonna dell'azione e selezionando tipi di nodi o collegamenti specifici.

Trovare codice sorgente in una soluzione di Visual Studio

Per utilizzare le query predefinite incluse in questa versione, vedere Trovare query salvate. In alternativa, è possibile utilizzare Visualizzazione soluzione o Visualizzazione classi in Esplora architettura per esplorare il codice sorgente fino al livello delle strutture ad albero dell'espressione:

• Visualizzazione classi offre una visualizzazione logica di una soluzione di Visual Studio. Ad esempio, è possibile esplorare il codice in base a spazio dei nomi, classi, membri e così via.

  

  Visualizzazione classi in Esplora architettura

• Visualizzazione soluzione offre una visualizzazione fisica di una soluzione di Visual Studio. Ad esempio, è possibile esplorare il codice in base a progetto, file di progetto e così via.

  

  Visualizzazione soluzione in Esplora architettura Trovare query salvate

Per trovare codice sorgente nella soluzione

1. Nella prima colonna di Esplora architettura fare clic su Visualizzazione classi o Visualizzazione soluzione in Visual Studio <nome soluzione>.

   A destra della prima colonna viene visualizzata una colonna del nodo. In questa colonna vengono mostrati tutti i nodi disponibili nella visualizzazione selezionata. Ad esempio, se è stata selezionata Visualizzazione classi, saranno elencati tutti gli spazi dei nomi logicamente presenti nella soluzione.

2. Nella colonna del nodo selezionare uno o più nodi per visualizzare la successiva colonna di nodi correlati. Per selezionare tutti i nodi nella colonna corrente, premere CTRL+A.

3. Ripetere il passaggio 2 finché non vengono trovati i nodi desiderati.

   Nota

   Per riavviare la query cancellando le colonne, sotto la barra del titolo di Esplora architettura fare clic su Cancella colonne.

Trovare codice compilato in un assembly gestito o in file eseguibili

Utilizzare Seleziona file in Esplora architettura per esplorare assembly gestiti fino al livello di chiamate da metodo a metodo.

Per trovare codice compilato

1. Scegliere Finestre dal menu Architettura, quindi fare clic su Esplora architettura.

2. Nella prima colonna fare clic su Seleziona file in File system.

3. Nella finestra di dialogo Apri passare all'assembly gestito (file con estensione dll) o ai file eseguibili (con estensione exe), selezionarli, quindi fare clic su Apri.

   Vengono visualizzati una colonna del nodo e i file selezionati.

4. Nella colonna del nodo selezionare uno o più file.

   Vengono visualizzati un'altra colonna del nodo e tutti i nodi nei file selezionati.

5. Selezionare uno o più nodi per visualizzare la successiva colonna di nodi correlati. Per selezionare tutti i nodi nella colonna corrente, premere CTRL+A.

6. Ripetere il passaggio 4 fino a trovare i nodi desiderati.

Perfezionare i risultati dell'esplorazione

È possibile perfezionare i risultati della sessione di esplorazione nei modi seguenti:

• Filtrare nodi nella colonna corrente in base al nome.

• Filtrare nodi nella colonna corrente in base al tipo di nodo o alla proprietà.

• Filtrare nodi nella colonna successiva in base al tipo di nodo.

• Filtrare nodi nella colonna successiva in base al tipo di collegamento.

• Raggruppare nodi in base al contenitore o al valore della proprietà

Filtrare nodi nella colonna corrente in base al nome

Filtrare la colonna corrente in base al nome

Per filtrare nodi nella colonna corrente in base al nome

1. In Esplora architettura fare clic sull'area ombreggiata nella parte superiore della colonna del nodo per mostrare la casella del filtro.

2. Digitare il nome, quindi e premere INVIO.

   Nella colonna corrente vengono mostrati solo i nodi corrispondenti. Nell'angolo inferiore destro della colonna viene visualizzata una filigrana per indicare che la colonna è filtrata.

Filtrare nodi nella colonna corrente in base al tipo di nodo o alla proprietà

Filtrare nodi nella colonna corrente in base al tipo o alla proprietà

Per filtrare nodi nella colonna corrente in base al tipo o alla proprietà

1. In Esplora architettura fare clic sull'area ombreggiata nella parte superiore della colonna del nodo per mostrare la casella del filtro.

2. A sinistra della casella del filtro fare clic sul pulsante Filtra elementi nella colonna corrente per categoria e proprietà.

3. Per mostrare solo i nodi di un tipo specifico, in Categorie fare clic sui tipi desiderati.

4. Per mostrare solo i nodi con proprietà specifiche, in Proprietà fare clic sulle proprietà desiderate.

5. Una volta completata l'operazione, fare clic su OK.

   Nella colonna corrente vengono mostrati solo i nodi corrispondenti. Nell'angolo inferiore destro della colonna viene visualizzata una filigrana per indicare che la colonna è filtrata.

Filtrare nodi nella colonna successiva in base al tipo di nodo

Per filtrare nodi nella colonna successiva in base al tipo di nodo

1. In Esplora architettura passare alla colonna del nodo che precede i nodi che si desidera visualizzare, quindi selezionare i nodi desiderati.

2. Sul lato destro della colonna del nodo fare clic sulla colonna dell'azione compressa per espanderla.

   Nota

   La colonna dell'azione viene visualizzata evidenziata quando si sposta il puntatore su di essa.

3. Nella colonna dell'azione selezionare i tipi specifici di nodi che si desidera visualizzare successivamente in Navigazione nodi.

   Nota

   Per visualizzare un'unione di questi tipi, selezionare più tipi.

   Vengono visualizzati una colonna del nodo e tutti i nodi corrispondenti.

Filtrare nodi nella colonna successiva in base al tipo di collegamento

In Esplora architettura i tipi di collegamento utilizzati per filtrare il successivo set di nodi vengono organizzati in due categorie: in ingresso o in uscita. Queste categorie descrivono la direzione del collegamento rispetto al nodo attualmente selezionato. Un collegamento in uscita punta dal nodo attualmente selezionato al successivo nodo correlato. Un collegamento in ingresso punta dal precedente nodo correlato al nodo attualmente selezionato. Quando si seleziona un tipo di collegamento in uscita, in Esplora architettura viene mostrato il successivo livello di nodi correlati. Quando si seleziona un tipo di collegamento in ingresso, in Esplora architettura viene mostrato il precedente livello di nodi correlati.

Ad esempio, se si seleziona un nodo della classe e si seleziona il tipo di collegamento in uscita Contiene, in Esplora architettura vengono mostrati i nodi contenuti nel nodo della classe. Se per tale nodo della classe si seleziona il tipo di collegamento in ingresso Contenuto da, vengono mostrati i nodi che contengono tale classe, ad esempio spazi dei nomi, file di classe e progetti.

Per filtrare nodi nella colonna successiva in base al tipo di collegamento

1. In Esplora architettura passare alla colonna del nodo che precede i nodi che si desidera visualizzare, quindi selezionare i nodi desiderati.

2. Sul lato destro della colonna del nodo fare clic sulla colonna dell'azione compressa per espanderla.

   Nota

   La colonna dell'azione viene visualizzata evidenziata quando si sposta il puntatore su di essa.

3. Nella colonna dell'azione selezionare uno degli elementi seguenti:

   • Per visualizzare nodi correlati al livello successivo, in Navigazione esterna selezionare i tipi di collegamento desiderati.

   • Per visualizzare nodi correlati al livello precedente, in Navigazione interna selezionare i tipi di collegamento desiderati.

     Nota

     Per visualizzare un'unione di questi tipi, selezionare più tipi.

   Vengono visualizzati la colonna successiva e tutti i nodi corrispondenti.

Raggruppare nodi in base al contenitore o al valore della proprietà

In Esplora architettura è possibile creare gruppi di nodi in base alle relazioni di contenimento esistenti o ai valori della proprietà. Se il raggruppamento è possibile, quando si completa questa attività verrà visualizzato un elenco di nuovi nodi di gruppo.

Quando si crea un grafico da questi gruppi in Esplora architettura, è possibile utilizzare il comando Mostra tutto come gruppi per organizzare nodi collegati in gruppi. Per ulteriori informazioni, vedere i seguenti argomenti:

• Procedura: generare grafici di dipendenze per il codice .NET

• Procedura: esplorare documenti grafico e spostarsi tra di essi

È inoltre possibile utilizzare gruppi per organizzare nodi in un grafico esistente. Per ulteriori informazioni, vedere Procedura: modificare e personalizzare documenti grafico.

Per raggruppare nodi in base al contenitore o al valore della proprietà

1. In Esplora architettura passare alla colonna del nodo che contiene i nodi che si desidera raggruppare. Per selezionare tutti gli elementi nella colonna, premere CTRL+A.

2. Sul lato destro della colonna del nodo fare clic sulla colonna dell'azione compressa per espanderla.

   Nota

   La colonna dell'azione viene visualizzata evidenziata quando si sposta il puntatore su di essa.

3. Nella colonna dell'azione in Raggruppamento:

   Fare clic su	Quindi
   Raggruppa per contenitori per visualizzare tutti i gruppi disponibili	Per visualizzare nodi presenti in questi gruppi, selezionare alcuni gruppi. Nella colonna successiva vengono mostrati i nodi contenuti nei gruppi selezionati.
   Raggruppa per proprietà per visualizzare tutte le proprietà disponibili	Selezionare le proprietà che si desidera utilizzare come gruppi. Nella colonna successiva vengono mostrati gruppi organizzati in base al valore della proprietà. Per visualizzare nodi con valori della proprietà specifici, selezionare alcuni gruppi di valori della proprietà. Il numero e i tipi di gruppi visualizzati sono basati sui tipi di valori della proprietà: Valori booleani: True e False Valori Integer: quattro gruppi che dividono l'intervallo di valori in quartili pari. Valori stringa: viene visualizzato un gruppo per ogni valore stringa univoco e i nodi appartengono a ciascuno gruppo in base al relativo valore della proprietà particolare. Ciò è molto utile quando la proprietà selezionata dispone dello stesso valore stringa in più nodi. Ad esempio, se si seleziona una proprietà con un valore stringa univoco per ogni nodo, si otterrà un solo gruppo per nodo.

Aggiornare i risultati dell'esplorazione

Per visualizzare qualsiasi modifica apportata al codice o alla soluzione, è necessario aggiornare manualmente Esplora architettura.

Per aggiornare Esplora architettura

1. In Esplora architettura passare alla colonna del nodo che precede la colonna che si desidera aggiornare.

2. Nella colonna corrente selezionare i nodi correlati ai nodi aggiornati.

   Viene visualizzata un'altra colonna del nodo per mostrare l'elenco di nodi aggiornato.

Salvare la sessione di esplorazione come query

È possibile salvare la sessione di esplorazione in Esplora architettura come query, ovvero come file con estensione dgql (Directed Graph Query Language). È possibile salvare una query su disco per utilizzarla in un secondo momento o generare grafici in modalità batch tramite lo strumento GraphCmd.exe. Per ulteriori informazioni sulla generazione di documenti grafici in modalità batch e DGQL, vedere Procedura: generare grafici di dipendenze per il codice .NET.

Per salvare la sessione di esplorazione

1. Sotto la barra del titolo di Esplora architettura fare clic su Salva query.

2. Nella finestra di dialogo Salva con nome assegnare un nome alla query e salvarla come file con estensione dgql nella cartella Queries locale nel percorso seguente:

   …\Documenti\Visual Studio 2010\ArchitectureExplorer\Queries

   Nota

   Per visualizzare la query in Esplora architettura, è necessario salvare il file con estensione dgql nella cartella Queries o aggiungerlo alla soluzione. Per ulteriori informazioni, vedere Trovare query salvate.

Trovare query salvate

È possibile utilizzare Esplora architettura per trovare file di query (con estensione dgql) quando vengono aggiunti alla soluzione di Visual Studio o quando vengono salvati nella cartella locale Queries nel percorso …\Documenti\Visual Studio 2010\ArchitectureExplorer\Queries. Questa cartella contiene anche query predefinite di uso comune. 

Per ulteriori informazioni sul salvataggio della sessione di esplorazione come una query in Esplora architettura, vedere Salvataggio della sessione di esplorazione.

Query nella soluzione

Per trovare query nella soluzione

1. Scegliere Esplora architettura dal menu Visualizza.

2. Nella prima colonna fare clic su In soluzione personale in Query DGQL salvate per visualizzare una colonna di file di query (con estensione dgql).

3. Nella colonna di file di query fare clic su un file di query.

   Vengono visualizzati un'altra colonna e i nodi della query selezionata.

4. Selezionare uno o più nodi per visualizzare la successiva colonna di nodi correlati. Per selezionare tutti i nodi nella colonna corrente, premere CTRL+A.

5. Ripetere il passaggio 4 finché non vengono trovati i nodi desiderati.

Per trovare query nella cartella Queries locale

1. Scegliere Esplora architettura dal menu Visualizza.

2. Nella prima colonna fare clic su In cartelle in Query DGQL salvate per visualizzare un elenco di file di query (con estensione dgql).

   Nella seguente tabella sono elencate le query predefinite che è possibile utilizzare per esplorare elementi nella soluzione:

   Nome del file di query	Consente di visualizzare
   All Assembly References.dgql	Tutti gli assembly a cui viene fatto riferimento dalla soluzione. Dai risultati della query è possibile generare un grafico che mostri le dipendenze tra questi assembly. Per ulteriori informazioni, vedere Procedura: generare grafici di dipendenze per il codice .NET.
   All Output Assemblies.dgql	Un elenco semplice di tutti gli assembly di output nella soluzione senza collegamenti di dipendenza. Dai risultati della query è possibile generare un grafico di dipendenze per gli assembly selezionati: Nella colonna corrente selezionare gli assembly che si desidera esplorare. Sul lato destro della colonna corrente fare clic sulla colonna dell'azione compressa per espanderla. Nota La colonna dell'azione viene visualizzata evidenziata quando si sposta il puntatore su di essa. Nella colonna dell'azione fare clic su Grafico standard in Comandi.
   All Project References.dgql	Tutti i riferimenti tra progetti nella soluzione. Dai risultati della query è possibile generare un grafico che mostri i riferimenti tra questi progetti. Per ulteriori informazioni, vedere Procedura: generare grafici di dipendenze per il codice .NET.
   All Projects.dgql	Un elenco semplice di tutti i progetti nella soluzione. Se nella soluzione sono incluse cartelle della soluzione, questo elenco sarà diverso da quello mostrato quando si fa clic su Visualizzazione soluzione in Esplora architettura.
   Constructors.dgql	Un elenco semplice di tutti i metodi del costruttore.
   Inheritance Graph.dgql	Tutti i tipi contenuti nella soluzione con le seguenti relazioni: Eredita da Implements Dai risultati della query è possibile generare un grafico che mostri le relazioni di ereditarietà tra questi tipi. Per ulteriori informazioni, vedere Procedura: generare grafici di dipendenze per il codice .NET.
   Public Classes.dgql	Un elenco semplice di tutte le classi pubbliche nella soluzione.
   Virtual Members.dgql	Un elenco semplice di tutti i membri virtuali nella soluzione.

3. Nella colonna di file di query fare clic su un file di query.

   Vengono visualizzati una colonna del nodo e i nodi della query selezionata.

4. Nella colonna del nodo selezionare uno o più nodi per visualizzare la colonna di nodi correlati. Per selezionare tutti i nodi nella colonna corrente, premere CTRL+A.

5. Ripetere il passaggio 4 finché non vengono trovati i nodi desiderati.

Vedere anche

Concetti

Visualizzazione del codice esistente