Freigeben über


Hinzufügen von Transact-SQL Codeausschnitten

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

Sie können ihrer eigenen Transact-SQL Codeausschnitte zur Gruppe vordefinierter Codeausschnitte hinzufügen, die in SQL Server enthalten sind.

Erstellen einer Transact-SQL Codeausschnittdatei

Der erste Teil der Erstellung eines Transact-SQL Codeausschnitts besteht darin, eine XML-Datei mit dem Text des Codeausschnitts zu erstellen. Die Datei muss über eine .snippet Dateierweiterung verfügen und die Anforderungen des Codeausschnittschemas erfüllen. Legen Sie die Codeausschnittsprache auf SQL fest.

Sie können die vordefinierten Codeausschnitte verwenden, die mit SQL Server als Beispiele geliefert werden. Um die vordefinierten Codeausschnitte zu finden, öffnen Sie SQL Server Management Studio, wählen Sie das Menü "Extras " und dann den Codeausschnitt-Manager aus. Wählen Sie SQL- im Listenfeld Sprache aus, der Pfad zu den Transact-SQL Codeausschnitten wird im Feld Speicherort angezeigt.

Registrieren des Codeausschnitts

Verwenden Sie nach dem Erstellen der Codeausschnittdatei den Codeausschnitt-Manager, um den Codeausschnitt mit SQL Server Management Studio zu registrieren. Sie können entweder einen Ordner mit mehreren Codeausschnitten hinzufügen oder einzelne Codeausschnitte in den Ordner "Meine Codeausschnitte" importieren.

Prozeduren

Hinzufügen eines Codeausschnittordners

  1. Öffnen Sie SQL Server Management Studio.
  2. Wählen Sie das Menü "Extras " und dann den Codeausschnitt-Manager aus.
  3. Wählen Sie die Schaltfläche "Hinzufügen " aus.
  4. Navigieren Sie zu dem Ordner, der Ihre Codeausschnitte enthält, und wählen Sie die Schaltfläche "Ordner auswählen " aus.

Importieren eines Codeausschnitts

  1. Öffnen Sie SQL Server Management Studio.
  2. Wählen Sie das Menü "Extras " und dann den Codeausschnitt-Manager aus.
  3. Wählen Sie die Schaltfläche "Importieren " aus.
  4. Navigieren Sie zu dem Ordner, der Ihren Codeausschnitt enthält, wählen Sie die .snippet Datei aus, und wählen Sie die Schaltfläche " Öffnen " aus.

Beispiele

Im folgenden Beispiel wird ein TRY...CATCH Surround-With-Codeausschnitt erstellt und in SQL Server Management Studio importiert.

  1. Fügen Sie den folgenden Code in editor ein, und speichern Sie dann als Datei mit dem Namen TryCatch.snippet.

    <?xml version="1.0" encoding="utf-8" ?>
    <CodeSnippets
        xmlns="http://schemas.microsoft.com/VisualStudio/2005/CodeSnippet">
        <_locDefinition
            xmlns="urn:locstudio">
            <_locDefault _loc="locNone" />
            <_locTag _loc="locData">Title</_locTag>
            <_locTag _loc="locData">Description</_locTag>
            <_locTag _loc="locData">Author</_locTag>
            <_locTag _loc="locData">ToolTip</_locTag>
            <_locTag _loc="locData">Default</_locTag>
        </_locDefinition>
        <CodeSnippet Format="1.0.0">
            <Header>
                <Title>TryCatch</Title>
                <Shortcut></Shortcut>
                <Description>Example Snippet for Try-Catch.</Description>
                <Author>SQL Server Documentation Example</Author>
                <SnippetTypes>
                    <SnippetType>SurroundsWith</SnippetType>
                </SnippetTypes>
            </Header>
            <Snippet>
                <Declarations>
                    <Literal>
                        <ID>CatchCode</ID>
                        <ToolTip>Code to handle the caught error</ToolTip>
                        <Default>CatchCode</Default>
                    </Literal>
                </Declarations>
                <Code Language="SQL">
                    <![CDATA[
       BEGIN TRY
    
       $selected$ $end$
    
       END TRY
       BEGIN CATCH
    
       $CatchCode$
    
       END CATCH;
       ]]>
                </Code>
            </Snippet>
        </CodeSnippet>
    </CodeSnippets>
    
  2. Öffnen Sie SQL Server Management Studio.

  3. Wählen Sie das Menü "Extras " und dann den Codeausschnitt-Manager aus.

  4. Wählen Sie die Schaltfläche "Importieren " aus.

  5. Navigieren Sie zu dem Ordner, der die TryCatch.snippet Datei enthältTryCatch.snippet, und wählen Sie die Schaltfläche "Öffnen" aus. Sie sollten jetzt einen TryCatch Codeausschnitt im Ordner "Meine Codeausschnitte" haben.