新增 Transact-SQL 代碼段

發行項
02/20/2025

適用於：SQL Server Azure SQL Database Azure SQL 受控實例 Azure Synapse Analytics Analytics 平台系統（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 註冊代碼段。您可以新增包含多個代碼段的資料夾，或將個別代碼段匯入至 [我的代碼段] 資料夾。

程序

新增程式碼片段資料夾

開啟 SQL Server Management Studio。
選取 [工具] 選單，然後按下 [代碼段管理員]。
按一下 [新增] 按鈕。
導航至包含程式碼片段的資料夾，然後按下 [選取資料夾] 按鈕。

匯入代碼段

開啟 SQL Server Management Studio。
選取 [工具] 選單，然後按下 [代碼段管理員]。
按下匯入按鈕。
流覽至包含代碼片段的資料夾，點擊 .snippet 檔案，然後按 [開啟] 按鈕。

例子

下列範例建立 TRY-CATCH 的包圍片段，並將其匯入到 SQL Server Management Studio。

將下列程式代碼貼到記事本，然後儲存為名為 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 Books Online 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>

開啟 SQL Server Management Studio。
選取 [工具] 選單，然後按下 [代碼段管理員]。
按一下 [匯入] 按鈕。
流覽至包含 TryCatch.snippet 的資料夾，點選 TryCatch.snippet 檔案，然後點擊 [開啟] 按鈕。您現在應該在 My Code Snippets 資料夾中有 TryCatch snippet。

另請參閱

插入四周環繞 Transact-SQL 代碼段

共用方式為