添加 Transact-SQL 代码片段

项目
02/21/2025

适用于：SQL Server Azure SQL 数据库 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 文件，然后单击 “打开”按钮。现在，“我的代码片段” 文件夹中应该有一个 TryCatch 代码片段。

另请参阅

插入环绕 Transact-SQL 代码片段

通过