新增 Transact-SQL 片段

適用於：SQL ServerAzure SQL DatabaseAzure SQL 受控實例Azure Synapse AnalyticsAnalytics 平台系統 （PDW）

您可以將自己的 Transact-SQL 程式碼片段新增至 SQL Server 中包含的預先定義程式碼片段集。

建立 Transact-SQL 程式碼片段檔案

建立 Transact-SQL 代碼段的第一個部分是使用代碼段的文字建立 XML 檔案。 檔案必須具有 .snippet 副檔名，並符合 程式碼片段結構描述的要求。 將代碼段語言設定為 SQL。

您可以使用 SQL Server 隨附的預先定義程式碼片段作為範例。 若要尋找預先定義的程式碼片段，請開啟 SQL Server Management Studio，選取 [工具] 功能表，然後選取 [程式碼片段管理員]。 在 [語言] 列表框中選取 [SQL]，Transact-SQL 代碼段的路徑會顯示在 [位置] 方塊中。

註冊程式碼片段

建立代碼段檔案之後，請使用代碼段管理員向 SQL Server Management Studio 註冊代碼段。 您可以新增包含多個代碼段的資料夾，或將個別代碼段匯入至 [我的代碼段] 資料夾。

程序

新增程式碼片段資料夾

1. 開啟 SQL Server Management Studio。
2. 選取 工具 功能表，然後選取 程式碼片段管理員。
3. 選取 [新增 ] 按鈕。
4. 導覽至包含程式碼片段的資料夾，然後選取 選取資料夾 按鈕。

匯入程式碼片段

1. 開啟 SQL Server Management Studio。
2. 選取 工具 功能表，然後選取 程式碼片段管理員。
3. 選取 [匯入] 按鈕。
4. 導覽至包含程式碼片段的資料夾，選取檔案 .snippet ，然後選取 [ 開啟 ] 按鈕。

例子

下列範例會建立 TRY...CATCH 包圍程式碼片段，並將它匯入 SQL Server Management Studio。

1. 將以下程式碼貼到記事本中，然後儲存為名為 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. 開啟 SQL Server Management Studio。

3. 選取 工具 功能表，然後選取 程式碼片段管理員。

4. 選取 [匯入] 按鈕。

5. 導覽至包含 TryCatch.snippet的資料夾，選取檔案TryCatch.snippet，然後選取 開啟 按鈕。 您現在應該在「我的程式碼片段」資料夾中有一個TryCatch程式碼片段。

相關內容

• 插入環繞的 Transact-SQL 片段