Partager via


Ajouter des extraits de code Transact-SQL

s’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Vous pouvez ajouter vos propres extraits de code Transact-SQL à l’ensemble d’extraits de code prédéfinis inclus dans SQL Server.

Créer un fichier d’extrait de code Transact-SQL

La première partie de la création d’un extrait de code Transact-SQL consiste à créer un fichier XML avec le texte de votre extrait de code. Le fichier doit avoir une .snippet extension de fichier et répondre aux exigences du schéma d’extraits de code. Définissez le langage d’extrait de code sur SQL.

Vous pouvez utiliser les extraits de code prédéfinis fournis avec SQL Server comme exemples. Pour rechercher les extraits de code prédéfinis, ouvrez SQL Server Management Studio, sélectionnez le menu Outils , puis sélectionnez Gestionnaire d’extraits de code. Sélectionnez SQL dans la zone de liste Langue, le chemin d’accès aux extraits de code Transact-SQL s’affiche dans la zone Emplacement.

Inscrire l’extrait de code

Après avoir créé le fichier d’extraits de code, utilisez le Gestionnaire d’extraits de code pour inscrire l’extrait de code auprès de SQL Server Management Studio. Vous pouvez ajouter un dossier contenant plusieurs extraits de code ou importer des extraits de code individuels dans le dossier Mes extraits de code dossier.

Procédures

Ajouter un dossier d’extraits de code

  1. Ouvrez SQL Server Management Studio.
  2. Sélectionnez le menu Outils , puis sélectionnez Gestionnaire des extraits de code.
  3. Sélectionnez le bouton Ajouter .
  4. Accédez au dossier contenant vos extraits de code, puis sélectionnez le bouton Sélectionner un dossier .

Importer un extrait de code

  1. Ouvrez SQL Server Management Studio.
  2. Sélectionnez le menu Outils , puis sélectionnez Gestionnaire des extraits de code.
  3. Sélectionnez le bouton Importer .
  4. Accédez au dossier contenant votre extrait de code, sélectionnez le .snippet fichier, puis sélectionnez le bouton Ouvrir .

Exemples

L’exemple suivant crée un extrait de code « envelopper avec » et l’importe dans SQL Server Management Studio.

  1. Collez le code suivant dans le Bloc-notes, puis enregistrez en tant que fichier nommé 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. Ouvrez SQL Server Management Studio.

  3. Sélectionnez le menu Outils , puis sélectionnez Gestionnaire des extraits de code.

  4. Sélectionnez le bouton Importer .

  5. Accédez au dossier contenant TryCatch.snippet, sélectionnez le TryCatch.snippet fichier, puis sélectionnez le bouton Ouvrir . Vous devez maintenant avoir un TryCatch extrait de code dans votre dossier Mes extraits de code .