Codegliederung

gilt für:SQL ServerAzure SQL-Datenbankazure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Sie können das Gliederungsfeature in den SQL Server Management Studio-Abfrage-Editoren verwenden, um Code beim Bearbeiten von Abfragen selektiv auszublenden. Auf diese Weise können Sie den Code, an dem Sie arbeiten, einfacher anzeigen, insbesondere in großen Abfragedateien.

Gliederungsübersicht

Standardmäßig ist der gesamte Code sichtbar, wenn Sie ein Abfrage-Editor-Fenster öffnen. Bereiche des Codes können reduziert werden, um ihn aus der Ansicht auszublenden. Eine vertikale Linie am linken Rand des Editorfensters verwendet ein Quadrat mit einem Minuszeichen (-), um den Anfang der einzelnen reduzierbaren Codebereiche zu identifizieren. Wenn Sie ein Minuszeichen auswählen, wird der Text des Codebereichs durch ein Feld ersetzt, das drei Punkte (...) enthält, und das Minuszeichen wird zu einem Pluszeichen (+) geändert. Wenn Sie ein Pluszeichen auswählen, wird der reduzierte Code angezeigt, und das Pluszeichen ändert sich zu einem Minuszeichen. Wenn Sie den Mauszeiger über ein Feld mit drei Punkten bewegen, wird eine QuickInfo angezeigt, die den Code im reduzierten Abschnitt anzeigt.

Codeumriss aktivieren oder deaktivieren

Sie können diese Einstellung verwalten, indem Sie zu Tools>Optionennavigieren, den Abschnitt Text-Editor erweitern und IntelliSense-auswählen. Um die Codeumrissfunktion zu deaktivieren, deaktivieren Sie das Kontrollkästchen Anweisungen umreißen. Die Code-Gliederung ist standardmäßig aktiviert.

Systemumrissregionen

Jeder SQL Server Management Studio-Editor generiert eine Reihe von standardmäßigen, vom System definierten Gliederungsbereichen.

Die MDX- und DMX-Code-Editoren erstellen Gliederungsbereiche für jede mehrzeilige Anweisung. Dies ist die einzige Ebene der Gliederung, die diese Editoren unterstützen.

Analysis Services-XMLA-Abfrage-Editorbereiche

Der XMLA-Abfrage-Editor für Analysis Services generiert einen Gliederungsbereich für jedes mehrteilige XML-Attribut. Der Editor schachtelt die Gliederungsbereiche für geschachtelte Tags. Der XMLA-Editor erstellt beispielsweise drei Gliederungsbereiche für das folgende Dokument.

Wenn Sie das Minuszeichen in der <InnerTag> Zeile auswählen, wird nur die InnerTag reduziert, wie in der folgenden Abbildung dargestellt.

Wenn Sie den Mauszeiger über das Feld bewegen, das die drei Punkte (...) aufweist, wird der Code im reduzierten Bereich in einer QuickInfo angezeigt, wie in der folgenden Abbildung dargestellt.

Wenn Sie das Minuszeichen in der <MiddleTag> Zeile auswählen, werden sowohl die MiddleTag als auch InnerTag reduziert, wie in der folgenden Abbildung dargestellt.

Wenn Sie das Minuszeichen in der <OuterTag> Zeile auswählen, werden alle drei Zeilen reduziert, wie in der folgenden Abbildung dargestellt.

Abfrage-Editorbereiche des Datenbankmoduls

Der Abfrage-Editor des Datenbankmoduls generiert Gliederungsbereiche für jedes Element in der folgenden Hierarchie:

1. Haufen. Der erste Batch ist der Code vom Anfang der Datei bis zum ersten GO Befehl oder ende der Datei, wenn keine GO Befehle vorhanden sind. Nach dem ersten GOgibt es einen Batch aus jedem GO Befehl zum nächsten GO Befehl oder zum Ende der Datei.

2. Durch die folgenden Schlüsselwörter getrennte Blöcke:

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

3. Mehrzeilige Anweisungen.

Beispielsweise erstellt der Abfrage-Editor des Datenbankmoduls drei Gliederungsbereiche für die folgende Abfrage:

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

Sie können das Minuszeichen in der SELECT * Zeile auswählen, um nur diese SELECT Anweisung zu reduzieren. Um den gesamten BEGIN - END-Block zu reduzieren, wählen Sie das Minuszeichen in der BEGIN Zeile aus. Um den gesamten Batch auf den Befehl GO zu reduzieren, wählen Sie das Minuszeichen in der CREATE PROCEDURE Zeile aus. Sie können die Zeilen SELECT GETDATE() oder SELECT @@VERSION nicht einzeln einklappen, da es sich um einzelzeilige Anweisungen handelt und sie keine Gliederungsbereiche erhalten.