使用英语阅读

通过


关于 UDT 示例的自述文件

[本主题为预先发布的文档内容,在未来的版本中可能会更改。包括以占位符形式出现的空白主题。请注意:为了提供更多的中文内容,Microsoft 引进了非传统翻译方式。在本预发行版本中,文档中的部分内容就是使用非传统翻译方式翻译。Microsoft 知道使用非传统翻译方式翻译的文档很难尽善尽美,内容中或许会有词汇、句法、语法方面的错误。本文档的正式版本将使用传统翻译方式翻译,提供与上一版本正式版相同的译文品质。]

此示例仅适用于 SQL Server 2005 和 SQL Server 2008,而不适用于 SQL Server 2005 之前的任何 SQL Server 版本。

UserDefinedDataType 示例介绍如何在 Transact-SQL 和使用 System.Data.SqlClient 的客户端应用程序中创建和使用简单用户定义数据类型。

备注

编译公共语言运行时集成示例时,与 SQL Server 一起分发的 Microsoft .NET Framework 编译器版本的路径必须是 PATH 环境变量中的第一个 Framework 目录。SQL Server 随附的编译器的位置为 驱动器:\WINNT\Microsoft.NET\Framework\v2.0.xxxxx驱动器:\Windows\Microsoft.NET\Framework\v2.0.xxxxx,其中 驱动器 为安装驱动器,xxxxx 为 SQL Server 随附的 .NET Framework 的版本。

默认的安装目录为 C:\Program Files\Microsoft SQL Server\100\Samples\Engine\Programmability\CLR\UserDefinedDataType。

必须先下载并安装 SQL Server 示例和示例数据库,然后才能查看或使用它们。有关详细信息,请参阅安装 SQL Server 示例和示例数据库的注意事项

应用场景

开发人员希望表示、保存和使用复数。

语言

Transact-SQL、Visual C# 和 Visual Basic。

功能

UserDefinedDataType 示例使用下列 SQL Server 功能:

应用领域 功能

整体

CLR

必备组件

在运行此示例之前,请确保已安装下列软件:

  • Microsoft SQL Server 或 Microsoft SQL Server Express。您可以从 SQL Server Express 文档和示例网站上免费获取 SQL Server Express。
  • SQL Server 开发人员网站上提供的 AdventureWorks2008R2 数据库。
  • SQL Server 开发人员网站上提供的 SQL Server 数据库引擎示例。
  • .NET Framework SDK 2.0 或 Microsoft Visual Studio 2005。可以免费获取 .NET Framework SDK。请参阅安装 .NET Framework 文档

生成示例

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

生成强名称密钥文件

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

    - 或 -

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

  2. 使用更改目录命令 (CD) 将命令提示符窗口的当前目录更改为安装了示例的文件夹。

    备注

    若要确定示例所在的文件夹,请单击“开始”按钮,依次指向“所有程序”、“Microsoft SQL Server”、“文档和教程”,然后单击“示例目录”。如果使用了默认安装位置,则示例位于 <系统驱动器>:\Program Files\Microsoft SQL Server\100\Samples 中。

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

    sn -k SampleKey.snk

    备注

    有关强名称密钥对的详细信息,请参阅 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\ComplexNumber.sln

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

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

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

    此文件包含可在 SQL Server 中安装和注册 CLR 集成 UDT 示例的脚本。

运行示例

若要运行示例,请执行以下操作:

运行示例

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

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

    此脚本从 Transact-SQL 中调用示例 CLR 集成 UDT 对象。

  2. 执行 clientsample.exe,指定在命令行中将示例用户定义数据类型安装到的数据库的名称。这个简单的控制台应用程序使用 System.Data.SqlClient 调用示例用户定义数据类型。

删除示例

若要删除示例,请执行以下操作:

删除示例

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

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

    此脚本删除 UDT 示例。

注释

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

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

请参阅

概念

CLR 可编程性示例

帮助和信息

获取 SQL Server 2008 R2 帮助