Struttura del codiceCode Outlining

La modalità struttura negli editor di query di SQL Server Management StudioSQL Server Management Studio consente di nascondere in modo selettivo il codice quando si modificano query.You can use the outlining feature in the SQL Server Management StudioSQL Server Management Studio query editors to selectively hide code when you edit queries. In questo modo è possibile visualizzare più facilmente il codice utilizzato, soprattutto in file di query di dimensioni elevate.This enables you to more easily view the code you are working on, especially in large query files.

Panoramica sulla strutturaOutlining Overview

Per impostazione predefinita, quando si apre una finestra dell'editor di query tutto il codice è visibile.By default, all code is visible when you open a query editor window. È possibile comprimere alcune aree del codice per nasconderne la visualizzazione.Regions of the code can be collapsed to hide it from view. In una riga verticale sul bordo sinistro della finestra dell'editor viene utilizzato un quadrato con un segno meno (-) per identificare l'inizio di ogni area di codice comprimibile.A vertical line on the left edge of the editor window uses a square with a minus sign (-) to identify the start of each collapsible code region. Quando si fa clic sul segno meno, il testo dell'area del codice viene sostituito con una casella che contiene tre punti (...) e il segno meno viene modificato in un segno più (+).When you click a minus sign, the text of the code region is replaced with a box that contains three periods (…), and the minus sign changes to a plus sign (+). Quando si fa clic sul segno più, il codice compresso viene visualizzato e il segno più viene modificato in un segno meno.When you click a plus sign, the collapsed code appears and the plus sign changes to a minus sign. Quando si sposta il puntatore su una casella in cui sono presenti i tre punti, viene visualizzata una descrizione di comando in cui viene mostrato il codice contenuto nella sezione compressa.When you move the pointer over a box that has three periods, a tooltip appears that shows the code in the collapsed section.

Aree della struttura di sistemaSystem Outline Regions

Ogni editor di SQL Server Management StudioSQL Server Management Studio genera un set di aree della struttura predefinite stabilite dal sistema.Each SQL Server Management StudioSQL Server Management Studio editor generates a set of default, system-defined outline regions.

Gli editor del codice MDX e DMX creano aree della struttura per ogni istruzione su più righe.The MDX and DMX code editors create outline regions for each multiline statement. Questo è l'unico livello di struttura supportata da tali editor.This is the only level of outlining that these editors support.

Aree dell'editor di query XMLA di Analysis ServicesAnalysis Services XMLA Query Editor Regions

L'editor di query XMLA di Analysis ServicesAnalysis Services genera un'area della struttura per ogni attributo XML su più righe.The Analysis ServicesAnalysis Services XMLA Query Editor generates an outline region for each multiline XML attribute. L'editor nidifica le aree della struttura per i tag nidificati.The editor nests the outline regions for nested tags. L'editor XMLA, ad esempio, crea tre aree della struttura per il documento seguente.For example, the XMLA Editor creates three outline regions for the following document.

Codice XML in cui è illustrata la strutturaXML code showing outlining

Quando si fa clic sul segno meno nella riga <InnerTag, viene compressa solo la parte relativa a InnerTag, come illustrato nella figura seguente.When you click the minus sign on the <InnerTag> line, just the InnerTag is collapsed, as shown in the following illustration.

Codice XML con il nodo interno nascostoXML code with inner node hidden

Quando si sposta il puntatore sulla casella in cui sono presenti i tre punti (…), il codice contenuto nell'area compressa viene visualizzato in una descrizione di comando, come illustrato nella figura seguente.When you move the pointer over the box that has the three periods (…), the code in the collapsed region appears in a tooltip, as shown in the following illustration.

Codice XML con una descrizione comando che mostra il codice nascostoXML code with tooltip showing hidden code

Quando si fa clic sul segno meno nella riga <MiddleTag>, vengono compresse le parti relative a MiddleTag e InnerTag, come illustrato nella figura seguente.When you click the minus sign on the <MiddleTag> line, both the MiddleTag and InnerTag are collapsed, as shown in the following illustration.

Codice XML con i tag interni e centrali nascostiXML code with inner and middle tags hidden

Quando si fa clic sul segno meno nella riga <OuterTag>, vengono compresse tutte e tre le righe, come illustrato nella figura seguente.When you click the minus sign on the <OuterTag> line, all three lines are collapsed, as shown in the following illustration.

Codice XML in cui sono illustrati tutti e tre i tag nascostiXML code showing all three tags hidden

Aree dell'editor di query del Motore di databaseDatabase Engine Query Editor Regions

L'editor di query del Motore di databaseDatabase Engine genera aree di struttura per ogni elemento presente nella gerarchia seguente:The Motore di databaseDatabase Engine Query Editor generates outline regions for each element in the following hierarchy:

  1. Batch.Batches. Il primo batch è rappresentato dal codice dall'inizio del file fino al primo comando GO o fino alla fine del file nel caso in cui non siano presenti comandi GO.The first batch is the code from the start of the file to either the first GO command or the end of the file when there are no GO commands. Dopo il primo comando GO, è presente un batch da ogni comando GO fino a quello successivo o fino alla fine del file.After the first GO, there is one batch from each GO command to either the next GO command or the end of the file.

  2. Blocchi delimitati dalle parole chiave seguenti:Blocks delimited by the following keywords:

    • BEGIN - ENDBEGIN - END

    • BEGIN TRY - END TRYBEGIN TRY - END TRY

    • BEGIN CATCH - END CATCHBEGIN CATCH - END CATCH

  3. Istruzioni su più righe.Multiline statements.

    L'editor di query del Motore di databaseDatabase Engine crea ad esempio tre aree della struttura per la query seguente:For example, the Motore di databaseDatabase Engine Query Editor creates three outline regions for the following query:

CREATE PROCEDURE Sales.SampleProc --Outline region 1  
AS  
BEGIN --Outline region 2   
  SELECT GETDATE() AS TimeOfQuery;  
  SELECT * --Outline region 3  
  FROM sys.transmission_queue;  
  SELECT @@VERSION;  
END;  
GO  

È possibile fare clic sul segno di meno sulla riga SELECT * per comprimere solo l'istruzione SELECT specifica.You can click the minus sign on the SELECT * line to collapse just that SELECT statement. Per comprimere l'intero blocco BEGIN - END , fare clic sul segno meno sulla riga BEGIN .To collapse the whole BEGIN - END block, click the minus sign on the BEGIN line. Per comprimere l'intero batch fino al comando GO , fare clic sul segno meno sulla riga CREATE PROCEDURE .To collapse the whole batch to the GO command, click the minus sign on the CREATE PROCEDURE line. Non è possibile comprimere la riga SELECT GETDATE() o SELECT @@VERSION singolarmente poiché ognuna costituisce un'istruzione su un'unica riga e non definisce aree della struttura.You cannot collapse the SELECT GETDATE() or SELECT @@VERSION lines individually because they are single line statements and do not get outlining regions.