Code-overzicht

Van toepassing op: SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

U kunt de overzichtsfunctie in de QUERY-editors van SQL Server Management Studio gebruiken om code selectief te verbergen wanneer u query's bewerkt. Hierdoor kunt u eenvoudiger de code bekijken waaraan u werkt, met name in grote querybestanden.

Overzicht schetsen

Standaard is alle code zichtbaar wanneer u een queryeditorvenster opent. Delen van de code kunnen worden ingeklapt om deze uit het zicht te verbergen. Een verticale lijn aan de linkerkant van het editorvenster gebruikt een vierkant met een minteken (-) om het begin van elk samenvouwbaar codegebied te identificeren. Wanneer u een minteken selecteert, wordt de tekst van het codegebied vervangen door een vak met drie punten (...) en verandert het minteken in een plusteken (+). Wanneer u een plusteken selecteert, wordt de samengevouwen code weergegeven en verandert het plusteken in een minteken. Wanneer u de aanwijzer over een vakje met drie punten verplaatst, verschijnt er een tooltip die de code in de samengevouwen sectie toont.

Code-overzicht in- of uitschakelen

U kunt deze instelling beheren door te navigeren naar Extra>Opties, de sectie Teksteditor uit te vouwen en IntelliSense-te selecteren. Om code-omtreklijnen uit te schakelen, vinkt u het selectievakje Code-omtreklijnen uit. Code-overzicht is standaard ingeschakeld.

Systeemoverzichtsregio's

Elke SQL Server Management Studio-editor genereert een set standaard, door het systeem gedefinieerde overzichtsregio's.

De MDX- en DMX-code editors maken overzichtsregio's voor elke opdracht met meerdere regels. Dit is het enige niveau waarin wordt aangegeven dat deze editors ondersteuning bieden.

XMLA-query-editorregio's van de Analysis Services

De XmlA-queryeditor van Analysis Services genereert een overzichtsregio voor elk XML-kenmerk met meerdere regels. De editor nest de overzichtsregio's voor geneste tags. De XMLA-editor maakt bijvoorbeeld drie overzichtsregio's voor het volgende document.

Wanneer u het minteken op de <InnerTag> lijn selecteert, wordt alleen de InnerTag samengevouwen, zoals weergegeven in de volgende afbeelding.

Wanneer u de muisaanwijzer over het vak met de drie punten (...) beweegt, verschijnt de code in het samengevouwen gebied in een tooltip, zoals te zien is in de volgende afbeelding.

Wanneer u het minteken op de <MiddleTag> regel selecteert, worden zowel de MiddleTag als InnerTag samengevouwen, zoals wordt weergegeven in de volgende afbeelding.

Wanneer u het minteken op de <OuterTag> regel selecteert, worden alle drie de regels samengevouwen, zoals wordt weergegeven in de volgende afbeelding.

Database-engine-queryeditorgebieden

De Database Engine-queryeditor genereert overzichtsregio's voor elk element in de volgende hiërarchie:

1. Batches. De eerste batch is de code vanaf het begin van het bestand naar de eerste GO opdracht of het einde van het bestand wanneer er geen GO opdrachten zijn. Na de eerste GOis er één batch van elke GO opdracht naar de volgende GO opdracht of het einde van het bestand.

2. Blokken gescheiden door de volgende trefwoorden:

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

3. Instructies met meerdere regels.

De Query-editor voor database-engine maakt bijvoorbeeld drie overzichtsregio's voor de volgende 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

U kunt het minteken op de SELECT * regel selecteren om alleen die SELECT instructie samen te vouwen. Als u het hele BEGIN - END blok wilt samenvouwen, selecteert u het minteken op de BEGIN regel. Als u de hele batch wilt samenvouwen naar de opdracht GO, selecteert u het minteken op de CREATE PROCEDURE regel. U kunt de SELECT GETDATE() of SELECT @@VERSION regels niet afzonderlijk samenvouwen omdat het eenregelinstructies zijn en geen omsluitende gebieden hebben.