新增 Transact-SQL 程式碼片段

發行項
07/08/2024

適用於： SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體 Azure Synapse Analytics Analytics Platform System (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 註冊程式碼片段。您可以加入包含多個程式碼片段的資料夾，或是將個別程式碼片段匯入到 [My Code 程式碼片段] 資料夾。

程序

加入程式碼片段資料夾

開啟 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 程式碼片段。

另請參閱

插入範圍陳述式 Transact-SQL 程式碼片段

共用方式為