通过

结果集示例

  • 项目

更新日期： 2006 年 7 月 17 日

有时，在通读查询结果时能够执行命令（而不需要打开新的连接并将所有结果读入内存）很有用。ADO .NET 2.0 中的多个活动的结果集 (MARS) 功能就是能够帮助您实现以上操作的方法。目前，用于服务器端编程的进程内的提供程序不能实现 MARS。若要消除此限制，可以使用服务器端游标。此示例说明如何使用服务器端游标解决对服务器端编程缺少 MARS 支持的问题。

ms160831.note(zh-cn,SQL.90).gif注意：
使用服务器端游标要消耗大量的服务器资源，并且有时会阻碍 Microsoft SQL Server 中的查询优化器增强查询的性能。因此，可以考虑重新编写代码来尽可能使用 JOIN。

除了可以在结果集中前后移动以外，此类的 API 与数据读取器相似，即使结果集处于打开状态时，也可以在连接时发出其他命令。

大大简化了此实现过程，以便使该示例易于理解。更有效的实现将提取多行来避免提取的每行的数据库周转。

与用查询的所有结果填充数据集比较，使用此类可以大大减少内存需求量，这对于服务器端编程是非常重要的。

此示例还说明如何使用“允许部分受信任的调用方”属性来指示结果集程序集是可以安全地从其他程序集进行调用的库。与使用 unsafe 权限注册调用程序集相比，此方法稍微复杂一些，但要安全许多。该方法更安全的原因是：它将调用程序集注册为 safe，调用程序集将限制相关资源脱离服务器并防止对服务器的完整性造成损害。

安装目录：

drive:\Program Files\Microsoft SQL Server\90\Samples\

Engine\Programmability\CLR\ResultSet\

应用场景

Jane 是 Adventure Works Cycles 的开发人员。她必须编写在从服务器端查询返回所有数据之前读取数据并执行其他操作的软件。

语言

Transact-SQL、Visual C# 和 Visual Basic。

功能

结果集示例使用 SQL Server 的以下功能。

应用领域 功能

整体

CLR、服务器端游标、Transact-SQL

必备组件

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

  • 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。

生成示例

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

生成强名称密钥文件

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

    - 或 -

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

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

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

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

    sn -k SampleKey.snk

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

生成结果集示例

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

    msbuild /nologo /verbosity:quiet /property:Configuration=Debug CS\ ResultSet.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. 在 Management Studio 中打开 scripts\test.sql 文件，然后运行该文件中包含的脚本，或在命令提示符窗口中运行以下命令：

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

删除示例

删除结果集示例

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

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

注释

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

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

请参阅

其他资源

Allowing Partially Trusted Callers

帮助和信息

获取 SQL Server 2005 帮助

更改历史记录

发布日期 历史记录

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

2006 年 7 月 17 日
已添加的内容：
  • 添加了介绍安全问题的内容。