使用 DB2 Everyplace .NET Data Provider 开发 ADO.NET 应用程序的概述

DB2 Everyplace .NET Data Provider 的名称空间如下所示：

在 .NET Compact Framework 上运行： IBM.Data.DB2.DB2e.CF
在 .NET Framework 上运行： IBM.Data.DB2.DB2e

DB2 Everyplace .NET Data Provider 提供用于连接至 DB2 Everyplace 数据源、执行命令和检索结果的功能。这些结果可直接处理，或放在 ADO.NET DataSet 中以便在处于断开连接状态时作进一步地处理。当在 DataSet 中时，数据可被用户见到（连同多个源中的其它数据）或在层与层之间远程传递。当在 DataSet 中时，对数据执行的任何处理都将与数据源协调。

DB2 Everyplace .NET Data Provider 被设计为轻量级的。它由 DB2 Everyplace 与扩展功能但未牺牲性能的代码之间的最小层组成。

DB2 Everyplace .NET Data Provider 类从其它 .NET Framework 类或接口继承或实现成员。此提供程序文档包括每个类中的受支持成员的摘要。有关特定继承成员的更详细信息，请参阅 Microsoft^(R) .NET Framework SDK 中的相应主题。

先决条件

表 6. 使用 DB2 Everyplace .NET Data Provider 的先决条件

组件	最小需求
Microsoft.NET Framework	Microsoft.NET Framework 1.0 必须安装它才能安装用于应用程序开发的 DB2 Everyplace .NET Data Provider
Microsoft Visual Studio.NET 2003	用于开发移动式应用程序的 Microsoft Visual Studio.NET 2003
Microsoft.NET Compact Framework	用于移动式开发的 Microsoft .NET Compact Framework 1.0 必须将它安装在设备上才能安装用于移动式应用程序开发的 DB2 Everyplace .NET Data Provider。
DB2 Everyplace 产品	版本 8.1.4 或以上版本的 `DB2e.dll` 版本 8.1.4 或以上版本的 AgentProxy.dll 是远程存储过程调用所必需的版本 8.1.4 或以上版本的 `wbxmllib.dll`，是远程存储过程调用所必需的。 DB2 Everyplace Sync Server V8.1.4 或以上版本，是远程存储过程调用所必需的 `DB2e.dll`、`AgentProxy.dll` 和 `wbxmllib.dll` 都是本机库（从而依赖于处理器）；因此，操作系统需要定位这些本机库（例如，设置环境变量 PATH）以使 DB2 Everyplace .NET Data Provider 正常工作。

限制

提供程序限制

对主键列的更新在 DB2 Everyplace 中目前是不允许的。
使用远程存储过程调用的结果集检索对结果集的大小有限制。
不支持本地存储过程调用。
对于不受支持的方法或属性，将抛出 System.NotSupportedException

线程安全

此提供程序的任何公用非实例成员对于多线程操作都是安全的。不能保证所有实例成员都是线程安全的。

过程

DB2 Everyplace .NET Data Provider 由四个核心对象组成。下表描述这些对象及其功能。

表 7. DB2 Everyplace .NET Data Provider，核心对象

对象	描述
DB2eConnection	建立与 DB2 Everyplace 数据源的连接且可以开始一个`事务`。
DB2eCommand	在 DB2 Everyplace 服务器上执行命令并显示`参数`。
DB2eDataAdapter	填充 `DataSet` 并使用 DB2 Everyplace 数据源解析更新。
DB2eDataReader	显示和读取来自 DB2 Everyplace 数据源的仅正向数据流。

除了先前表中列示的核心类，DB2 .NET Data Provider 还包含下表中列示的类。

表 8. DB2 Everyplace .NET Data Provider，附加类

对象	描述
DB2eCommandBuilder	一个帮助程序对象，将自动生成 `DB2eDataAdapter` 的命令属性或从存储过程派生参数信息并填充 `DB2eCommand` 对象的 `DB2eParameters` 集合。注意：不建议使用 `DB2eCommandBuilder`，原因是它可能生成效率非常低甚至无效（在某些情况下）的 SQL 语句。
DB2eError	显示 DB2 Everyplace 数据源返回的警告或错误中的信息。
DB2eException	在 DB2 Everyplace 数据源上遇到错误时返回。对于在客户机上遇到的错误，.NET 数据提供程序将抛出 .NET Framework 异常。
DB2eParameter	定义命令和存储过程的输入、输出和返回值参数。
DB2eTransaction	使您能够让命令加入 DB2 Everyplace 数据源中的事务。

要使用 DB2 Everyplace .NET Data Provider，必须将 IBM.Data.DB2.DB2e 或名称空间的 imports 或 using 语句添加至应用程序 .DLL，如以下代码所示：

[Visual Basic]: Imports IBM.Data.DB2.DB2e
[C#]: using IBM.Data.DB2.DB2e;

在编译代码时，还必须包括对 .DLL 的引用。例如，如果在编译 Microsoft^(R) Visual C#^(TM) 程序，命令行应包括：

csc /r:IBM.Data.DB2.DB2e.dll

对于 .NET Compact Framework，名称空间为 IBM.Data.DB2.DB2e.CF，而应用程序需要引用 IBM.Data.DB2.DB2e.CF.dll 汇编。

有关如何使此名称空间得到最好利用的信息，请参阅有关下列 DB2 Everyplace.NET Data Provider 类的文档：

有关 DB2 Everyplace .NET Data Provider 在 .NET Framework 内如何工作的更多信息，请参阅 IBM.Data.DB2.DB2e Hierarchy。

表 9. 类

对象	描述
DB2eCommand	表示要对数据源执行的 SQL 语句或存储过程。不能继承此类。
DB2eCommandBuilder	自动生成用于将对 `DataSet` 的更改与相关联的数据源协调的单个表命令。不能继承此类。
DB2eConnection	表示与数据源的打开连接。
DB2eDataAdapter	表示一组数据命令和与数据源的连接，它们用来填充 `DataSet` 并更新数据源。不能继承此类。
DB2eDataReader	提供一种方式读取来自数据源的仅正向数据行流。不能继承此类。
DB2eError	收集与数据源返回的警告或错误有关的信息。不能继承此类。
DB2eException	当 DB2 Everyplace 数据源返回警告或错误时生成的异常。不能继承此类。
DB2eParameter	表示 `DB2eCommand` 的参数及其对 `DataColumn` 的映射（可选）。不能继承此类。
DB2eTransaction	表示要在数据源上进行的 SQL 事务。不能继承此类。

表 10. 代表

代表	描述
DB2eInfoMessageEventHandler	表示将用来处理 DB2eConnection 的 InfoMessage 事件的方法。
DB2eRowUpdatedEventHandler	表示将用来处理 DB2eDataAdapter 的 RowUpdated 事件的方法。
DB2eRowUpdatingEventHandler	表示将用来处理 DB2eDataAdapter 的 RowUpdating 事件的方法。

表 11. 枚举

枚举	描述
DB2eType	指定字段、属性或 DB2eParameter 的数据类型。

表 12. DB2 Everyplace .NET Provider 连接字符串关键字

关键字	描述
Database	数据库位置。例如：`C:\data1\`
UID	用户标识
PWD	密码

C# 示例

string connString = @"Database=C:\data1\; UID=user; PWD=userpwd";

相关概念

相关任务