如何：创建和运行 CLR SQL Server 用户定义的函数

项目
08/18/2008

更新：2007 年 11 月

通过向 SQL Server 项目添加“用户定义函数”创建用户定义的 SQL 函数。部署成功后，可调用并执行用户定义的函数。

说明：
默认情况下，公共语言运行时 (CLR) 集成功能在 Microsoft SQL Server 中处于关闭状态，必须启用该功能才能使用 SQL Server 项目项。若要启用 CLR 集成，请使用 sp_configure 存储过程的 clr enabled 选项。有关更多信息，请参见启用 CLR 集成。

说明：
对于在以下说明中使用的某些 Visual Studio 用户界面元素，您的计算机可能会显示不同的名称或位置。这些元素取决于您使用的 Visual Studio 版本及设置。有关更多信息，请参见Visual Studio 设置。

创建用户定义的 SQL Server 函数

使用 Visual Studio 建立和部署此函数

打开一个现有的“SQL Server 项目”，或者创建一个新项目。有关更多信息，请参见如何：创建 SQL Server 项目。
从“项目”菜单中选择“添加新项”。
在“添加新项”对话框中选择“用户定义函数”。
键入新用户定义函数的“名称”。
添加执行用户定义函数时运行的代码。请参见此过程后面的第一个示例。

说明：

C++ 示例在编译时必须使用 /clr:safe 编译器选项。
对于 Visual Basic 和 Visual C#，在“解决方案资源管理器”中，打开“TestScripts”文件夹，然后双击“Test.sql”文件，以打开它进行编辑。添加执行您的用户定义函数的代码。请参见此过程后面的第二个示例。

对于 Visual C++，在“解决方案资源管理器”中双击“debug.sql”文件，以打开它进行编辑。添加执行您的用户定义函数的代码。请参见此过程后面的第二个示例。
将用户定义函数部署到 SQL Server。有关更多信息，请参见如何：将 SQL Server 项目项部署到 SQL Server 中。
按 F5 通过在 SQL Server 上执行用户定义的函数来对其进行调试。

说明：
C++ 示例在编译时必须使用 /clr:safe 编译器选项。

说明

下面的代码示例创建用户定义的将价格作为参数的标量函数 addTax，添加销售税并返回价格和销售税的加和。

创建该函数后，将其部署到 SQL Server。有关更多信息，请参见如何：将 SQL Server 项目项部署到 SQL Server 中

代码

Imports System.Data.SqlTypes
Imports Microsoft.SqlServer.Server

Partial Public Class UserDefinedFunctions

    Public Const SALES_TAX As Double = 0.086

    <SqlFunction()> _
    Public Shared Function addTax(ByVal originalAmount As SqlDouble) As SqlDouble

        Dim taxAmount As SqlDouble = originalAmount * SALES_TAX

        Return originalAmount + taxAmount
    End Function
End Class

using System.Data.SqlTypes;
using Microsoft.SqlServer.Server;

public partial class UserDefinedFunctions
{
    public const double SALES_TAX = .086;

    [SqlFunction()]
    public static SqlDouble addTax(SqlDouble originalAmount)
    {
        SqlDouble taxAmount = originalAmount * SALES_TAX;

        return originalAmount + taxAmount;
    }
}

#include "stdafx.h"

#using <System.dll>
#using <System.Data.dll>
#using <System.Xml.dll>

using namespace System;
using namespace System::Data;
using namespace System::Data::Sql;
using namespace System::Data::SqlTypes;
using namespace Microsoft::SqlServer::Server;

// In order to debug your Aggregate, add the following to your debug.sql file:
//
// SELECT dbo.addTax(10)
//

public ref class UserDefinedFunctions
{
public:
    static initonly double SALES_TAX = 0.086;

    [SqlFunction()]
    static SqlDouble AddTax(SqlDouble originalAmount)
    {
        SqlDouble taxAmount = originalAmount * SALES_TAX;

        return originalAmount + taxAmount;
    }
};

说明

向您的项目中 TestScripts 文件夹中的 Test.sql（在　Visual C++ 中为 debug.sql）文件，添加用于测试用户定义函数的代码。例如，若要测试此函数，请使用查询，如“SELECT dbo.addTax(10)”。您应见到返回的值“10.86”。

代码

SELECT dbo.addTax(10)

请参见

通过

如何：创建和运行 CLR SQL Server 用户定义的函数

创建用户定义的 SQL Server 函数

使用 Visual Studio 建立和部署此函数

说明

代码

说明

代码

请参见

任务

概念

参考

其他资源

其他资源