通过

数组参数示例

  • 项目

更新日期： 2006 年 4 月 14 日

有时需要创建、更新或删除数据库中的一组行。实现的方法有多种。其中一种是使用 CLR 集成用户定义数据类型将客户端上的数组信息传递到服务器上的公共语言运行时 (CLR) 集成存储过程。这类用户定义数据类型的特性将提供给服务器的数据大小限制在 8000 个字节。因此，此方法不适于大型数据或复杂数据。有关详细信息，请参阅 AdventureWorks Cycles CLR 层示例中的联系创建存储过程。如果操作的数据小且简单，则此方法比为每行调用存储过程有效得多。通过传递数组可以保留数据顺序，数据顺序对一些应用程序而言非常重要。

此示例包含以下内容：

  1. ContactTypeNames 用户定义数据类型，其中包含所需的联系类型名称列表。
  2. 实现为 Microsoft Visual C# 或 Microsoft Visual Basic 方法的 usp_EnsureContactTypeNames 存储过程。它接受 ContactTypeNames 用户定义数据类型的实例，并在 Person.ContactType 表中为联系名称插入新行，这些联系名称包含在用户定义数据类型实例中但在表中还不存在。
  3. TestArrayParameter 控制台应用程序。它基于传入的命令行参数创建 ContactTypeNames 用户定义数据类型的实例，然后通过将用户定义数据类型实例作为参数进行传递来调用 usp_EnsureContactTypeNames 存储过程。

安装目录：驱动器:\Program Files\Microsoft SQL Server\90\Samples\Engine\Programmability\CLR\ArrayParameter\

应用场景

Jane 是 Adventure Works Cycles 的开发人员。她必须将少量简单行插入表中，但希望尽量减少数据库的周转。

语言

Transact-SQL、Visual C# 和 Visual Basic。

功能

数组参数示例使用 Microsoft 的下列功能。

应用领域 功能

整体

CLR、用户定义数据类型、Transact-SQL

必备组件

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

  • Microsoft SQL Server 2005 或 Microsoft 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。

生成示例

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

生成强名称密钥文件

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

    - 或 -

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

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

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

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

    sn -k SampleKey.snk

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

生成数组参数示例

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

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

  2. 确保安装了 AdventureWorks 数据库。

  3. 如果没有将 SQL Server 数据库引擎 示例安装到默认位置，请在 Scripts\InstallCS.sql 中修改脚本的 CREATE ASSEMBLY 部分中的路径，使其指向示例的安装位置。

  4. 如果您不是要使用的 SQL Server 实例的管理员，则必须让管理员授予您 CreateAssembly 权限，才能完成安装。

  5. 根据编译的是 Visual C# 项目还是 Visual Basic 项目，在 SQL Server Management Studio 中打开 Scripts\installCS.sql 或 Scripts\installVB.sql 文件。执行文件中的脚本，或在命令提示符窗口中执行与以下命令类似的命令：

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

运行示例

运行数组参数示例

  1. 在命令提示符下，使用更改目录 (CD) 命令将命令提示符窗口的当前文件夹更改为 ArrayParameter 示例目录。在命令提示符下，运行以下命令：

    Scripts\TestCS.cmd

删除示例

删除数组参数示例

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

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

注释

必须启用 SQL Server 2005 或 SQL Server Express 的公共语言运行时，此示例才能正常运行。

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

请参阅

任务

AdventureWorks Cycles CLR 层

帮助和信息

获取 SQL Server 2005 帮助

更改历史记录

发布日期 历史记录

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