Esboço de código

Aplica-se a: SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Você pode usar o recurso de estrutura de tópicos nos editores de consulta do SQL Server Management Studio para ocultar seletivamente o código ao editar consultas. Isso permite que você visualize mais facilmente o código em que está trabalhando, especialmente em arquivos de consulta grandes.

Visão geral do esboço

Por padrão, todo o código fica visível quando você abre uma janela do editor de consultas. As regiões do código podem ser recolhidas para ocultá-lo da exibição. Uma linha vertical na borda esquerda da janela do editor usa um quadrado com um sinal de menos (-) para identificar o início de cada região de código recolhível. Ao selecionar um sinal de menos, o texto da região de código é substituído por uma caixa que contém três pontos (...) e o sinal de menos muda para um sinal de mais (+). Ao selecionar um sinal '+', o código recolhido aparece e o sinal '+' muda para um sinal '-'. Quando você move o ponteiro sobre uma caixa que tem três pontos, aparece uma dica de ferramenta que mostra o código na seção recolhida.

Ativar ou desativar a demarcação de código

Você pode gerenciar essa configuração navegando até Opções de ferramentas>, expandindo a seção Editor de texto e selecionando IntelliSense. Para desativar a estrutura de tópicos de código, desmarque a caixa de seleção Instruções de estrutura de tópicos . A estrutura de tópicos de código está habilitada por padrão.

Regiões de contorno do sistema

Cada editor do SQL Server Management Studio gera um conjunto de áreas padrão, definidas pelo sistema.

Os editores de código MDX e DMX criam regiões de delineamento para cada instrução multilinha. Este é o único nível de esboço que esses editores apoiam.

Regiões do editor de consulta XMLA do Analysis Services

O Editor de Consultas XMLA do Analysis Services gera uma região de estrutura para cada atributo XML multilinear. O editor aninha as áreas de estrutura para etiquetas aninhadas. Por exemplo, o Editor XMLA cria três regiões de estrutura de tópicos para o documento a seguir.

Quando você seleciona o <InnerTag> sinal de menos na linha, apenas o InnerTag é recolhido, conforme mostrado na ilustração a seguir.

Quando você move o ponteiro sobre a caixa que tem os três pontos (...), o código na região recolhida aparece em uma dica de ferramenta, conforme mostrado na ilustração a seguir.

Quando o sinal menos na linha <MiddleTag> é selecionado, ambos os MiddleTag e o InnerTag são recolhidos, conforme mostrado na ilustração a seguir.

Quando selecionas o sinal de menos na linha <OuterTag>, as três linhas são recolhidas, conforme mostrado na ilustração a seguir.

Regiões do editor de consultas do Mecanismo de Banco de Dados

O Editor de Consultas do Mecanismo de Banco de Dados gera regiões de estrutura hierárquica para cada elemento na hierarquia a seguir:

1. Lotes. O primeiro lote é o código desde o início do ficheiro até ao primeiro comando GO, ou o final do ficheiro quando não há comandos GO. Após o primeiro GO, há um lote de comandos de cada GO até ao próximo comando GO ou até ao final do ficheiro.

2. Blocos delimitados pelas seguintes palavras-chave:

   • BEGIN - END
   • BEGIN TRY - END TRY
   • BEGIN CATCH - END CATCH

3. Instruções multilinha.

Por exemplo, o Editor de Consultas do Motor de Base de Dados cria três regiões de estrutura para a seguinte consulta:

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

Você pode selecionar o sinal de menos na SELECT * linha para recolher apenas essa SELECT instrução. Para recolher todo o bloco BEGIN - END, selecione o sinal de menos na linha BEGIN. Para recolher todo o lote ao comando GO, selecione o sinal de menos na linha CREATE PROCEDURE. Não é possível recolher as linhas SELECT GETDATE() ou SELECT @@VERSION individualmente, pois são instruções de uma única linha e não formam regiões de contorno.