.NET 提供程序之间的差异

GBase 8s .NET Provider

GBase 8s .NET Provider（有时称为 CSDK .NET 提供程序）只与 GBase 8s 数据库服务器一起使用，并在内部使用 SQLI 协议与 GBase 8s 进行通信。GBase 8s .NET Provider 不再为新的 .NET API 而增强。

IBM Data Server .NET Provider

IBM Data Server .NET Provider（有时称为 Common .NET 提供程序）是用于应用程序开发的下一代 .NET 提供程序。此 .NET 提供程序包含若干功能（特别是在 Web 应用程序开发方面），使其成为新客户机开发领域的首选 .NET 提供程序。

受支持功能部件的比较

GBase 8s .NET Provider 和 IBM Data Server .NET Provider 支持的功能部件之间有几个主要区别。IBM Data Server .NET Provider 支持的许多功能部件不受 GBase 8s .NET Provider 支持。

下表显示了这些区别：

ConnectionString 属性中不支持的关键字

连接池设置

在 GBase 8s .NET Provider 中，Connection Lifetime 属性指定连接可以保持断开的时间。

在 IBM Data Server .NET Provider 中，Connection Lifetime 属性指定连接在池中保持断开和空闲的秒数。

ConnectionString 属性中的服务器关键字

在 GBase 8s .NET Provider 中，SERVER 关键字应当用于将 GBASEDBTSERVER 名称指定为 SetNet 实用程序中的设置。

在 IBM Data Server .NET Provider 中，SERVER 关键字应以格式 <hostname>:<port_number> 指定，其中 <hostname> 为实例的机器名称，而 <port_number> 为实例正在侦听的端口。

ConnectionString 属性中的数据库关键字

使用 GBase 8s .NET Provider，不指定数据库就可以连接到服务器。使用 IBM Data Server .NET Provider 时，database 为必需的属性。

GBase 8s .NET Provider 允许指定数据库属性的值，格式为 dbname@server。 IBM Data Server .NET Provider 不支持此格式。

ConnectionString 属性中用引号括起的字符串值

GBase 8s .NET Provider 支持用引号括起的数据库、服务器和密码关键字值。

使用 IBM Data Server .NET Provider 的应用程序仅可以在指定目录连接别名的情况下，通过以引号括起的方式为数据库和密码关键字指定值。

IfxConnection.ServerType 属性

对于此属性，GBase 8s .NET Provider 返回值 GBasedbt。 IBM Data Server .NET Provider 会返回从它所连接的数据库服务器接收到的值。例如，如果提供程序连接到安装在 UNIX 64 位系统上的 GBase 8t 数据库服务器，该提供程序可能会返回 IDS/UNIX64。

SQL 语句中不支持的数据类型

IBM Data Server .NET Provider 不允许访问 LIST、MULTISET、SET 或 ROW 数据类型，因为 GBase 8s DRDA 服务器不支持这些类型。

使用 GBase 8s .NET Provider，可以选择和返回 LIST、MULTISET 和 ROW 数据类型的值。

BYTE 和 TEXT 数据类型

IBM Data Server .NET Provider 可以将 Byte 和 BLOB 两种数据类型映射到 IfxBlob 数据类型。将 IfxBlob 对象作为参数绑定时，应用程序必须在参数标记后使用 ::byte 子句。此子句表明 IfxBlob 值对应一个字节列。没有 ::byte 子句时，会返回转换错误。

DB2Parameter clobParam;

clobParam.IfxType = IfxType.Clob;
...
cmd.CommandText = "CALL textSP(?::text)";
---
cmd.ExecuteNonQuery();

支持的数据类型

下表对比了较不常见的 GBase 8s 数据类型，以及每个 .NET 提供程序对这些数据类型的支持情况。

对比类和结构

下表对比了 .NET 提供程序对数据类型类和结构的支持差异。

存储过程差异

使用 GBase 8s .NET Provider，应用程序可以 ReturnValue 参数的方式来读取存储过程或函数的返回值。

使用 IBM Data Server .NET Provider，应用程序在缺省情况下可以数据阅读器的方式来读取存储过程或函数的返回值。要将其作为 ReturnValue 参数读取，应用程序必须将 IfxCommand 或 IfxConnection 对象中的 ResultSetAsReturnValue 参数设置为 true。要将其作为 ReturnValue 参数读取，应用程序必须将 IfxCommand 或 IfxConnection 对象中的 ResultSetAsReturnValue 属性设置为 true。

IfxCommand.ExecuteScalar() 方法

Cmd.CommandText = "SELECT COUNT(*) FROM Tab";

IfxDataReader.GetString() 方法

如果底层值为空，IBM Data Server .NET Provider 不允许使用 IfxDataReader.GetString() 方法。空值会引发 InvalidCast 异常。此行为与 GBase 8s .NET Provider 相反，GBase 8s .NET Provider 允许空值并会返回空字符串。

错误消息

IBM Data Server .NET Provider 接收到的某些错误消息与 GBase 8s .NET Provider 接收到的错误消息可能存在差异。例如，GBase 8s .NET Provider 的错误消息中有 [GBase 8s .NET provider] 这样的标记。而 IBM Data Server .NET Provider 的错误消息中只有 [IBM]。 此外，相同类型错误的错误代码可能也不同。