通过

UDT 实用工具

  • 项目

更新日期： 2005 年 12 月 5 日

UDTUtilities 示例包括很多实用工具函数。其中包括向 Transact-SQL 公开程序集元数据的函数、以表的形式返回程序集中的类型的示例流表值函数以及返回用户定义数据类型的字段、方法和属性的函数。说明的技术包括流式表值函数、.NET Framework 反射 API 以及从 Transact-SQL 中调用表值函数。

编译公共语言运行时 (CLR) 集成示例时，请注意与 SQL Server 2005 一起分发的 Microsoft .NET Framework 版本的编译器的路径必须是 PATH 环境变量中的第一个 Framework 目录。包含在 SQL Server 2005 中的编译器的位置为 drive:\WINNT\Microsoft.NET\Framework\v2.0.xxxxx 或 drive:\Windows\Microsoft.NET\Framework\v2.0.xxxxx，其中 drive 是安装驱动器、xxxxx 是包含在 SQL Server 2005 副本中的 .NET Framework 的版本。

默认的安装目录是 drive:\Program Files\Microsoft SQL Server\90\Samples\Engine\Programmability\CLR\UDTUtilities

应用场景

开发人员希望访问有关基于 CLR 用户定义数据类型的元数据。

语言

Transact-SQL、Visual C# 和 Visual Basic。

功能

UDTUtilities 示例使用以下 SQL Server 2005 功能：

应用领域 功能

整体

CLR

必备组件

在运行此示例之前，请确保安装了下列软件：

  • SQL Server 2005 或SQL Server 2005 Express Edition (SQL Server Express)。您可以从 SQL Server 2005 Express Edition 文档和示例网站免费获取 SQL Server Express。
  • SQL Server 2005 附带的 AdventureWorks 数据库还可以从 SQL Server 开发人员中心网站上获取。
  • SQL Server 2005 数据库引擎示例。这些示例包含在 SQL Server 2005 中。您可以从 SQL Server 开发人员中心网站上下载这些示例的最新版本。
  • .NET Framework SDK 2.0 或 Microsoft Visual Studio 2005。您可以免费获取 .NET Framework SDK。请参阅安装 .NET Framework SDK。

生成示例

如果尚未创建强名称密钥文件 ExternalSampleKey.snk，则请使用以下说明生成该密钥文件。

生成强名称密钥文件

  1. 打开 Microsoft Visual Studio 2005 命令提示。单击**“开始”，依次指向“所有程序”、Microsoft Visual Studio 2005 和“Visual Studio 工具”，再单击“Visual Studio 2005 命令提示”**。

    - 或者 -

    打开 Microsoft .NET Framework 命令提示。单击**“开始”，依次指向“所有程序”、Microsoft .NET Framework SDK 2.0，再单击“SDK 命令提示”**。

  2. 在命令提示符下，使用更改目录 (CD) 命令将命令提示窗口的当前文件夹更改为 Samples 文件夹。

    ms160746.note(zh-cn,SQL.90).gif注意：
    若要确定示例所在的文件夹，请单击“开始”，依次指向“所有程序”、Microsoft SQL Server 2005、“文档和教程”，然后单击“示例目录”。如果使用了默认安装位置，则示例将位于 <system_drive>:\Program Files\Microsoft SQL Server\90\Samples 中。

  3. 在命令提示符下，运行以下命令以生成密钥文件：

    sn -k ExternalSampleKey.snk

    ms160746.note(zh-cn,SQL.90).gif重要提示：
    有关强名称密钥对的详细信息，请参阅 MSDN 上 .NET 开发中心中的“安全简讯：.NET Framework 中的强名称和安全性”。

若要生成示例，请执行以下操作：

生成示例

  1. 通过使用 Visual Studio 2005 和所提供的 Visual Studio 解决方案或通过使用 Microsoft MSBuild（包括在 .NET Framework SDK 2.0 中）来编译示例。在命令提示符下运行与以下命令相似的命令：

    msbuild /nologo /verbosity:quiet /property:Configuration=Debug CS\UDTUtilities.sln

  2. 确保安装了 AdventureWorks 数据库，或者，如果需要，创建要在其中安装示例的数据库。

  3. 根据编译的是 Visual C# 项目还是 Visual Basic 项目，在 SQL Server Management Studio 中打开 scripts\installCS.sql 或 scripts\installVB.sql 文件。运行该文件中包含的脚本，或在命令提示符下运行与以下命令相似的命令：

    sqlcmd -E -I -i Scripts\InstallCS.sql

    此文件包括可在 SQL Server 中安装和注册实用工具示例的脚本。

运行示例

若要运行示例，请执行以下操作：

运行示例

  1. 在 Management Studio 中打开 scripts\test.sql 文件。运行该文件中包含的脚本，或在命令提示符下运行以下命令：

    sqlcmd -E -I -i Scripts\test.sql

    此脚本从 Transact-SQL 中调用示例实用工具示例对象。

删除示例

若要删除示例，请执行以下操作：

删除示例

  1. 在 Management Studio 中打开 scripts\cleanup.sql 文件。运行该文件中包含的脚本，或在命令提示符下运行以下命令：

    sqlcmd -E -I -i Scripts\cleanup.sql

    此脚本可删除示例。

注释

为了使此示例正确运行，必须启用 SQL Server 2005 或 SQL Server Express 的 CLR。

提供的示例仅供教学使用。这些示例不是针对生产环境设计的，也没有在生产环境中进行测试。对于这些示例，Microsoft 不提供相关的技术支持。未经系统管理员允许，不得将示例应用程序和程序集与生产 SQL Server 数据库或报表服务器相连或一起使用。

请参阅

概念

CLR 可编程性示例

帮助和信息

获取 SQL Server 2005 帮助

更改历史记录

发布日期 历史记录

2005 年 12 月 5 日
更改的内容：
  • 更改了有关生成密钥文件的说明，包括密钥文件的名称和位置。