DB2 V9.7 for Linux, UNIX, and Windows

DB2DataReader.GetBytes 方法

将从指定列偏移处开始的字节流以数组形式读入缓冲区中自给定缓冲区偏移处开始的位置。

名称空间:
IBM.Data.DB2
组合件:
IBM.Data.DB2(在 IBM.Data.DB2.dll 中)

语法

[Visual Basic]
Public Function GetBytes( _
   ByVal i As Integer, _
   ByVal dataIndex As Long, _
   ByVal buffer() As Byte, _
   ByVal bufferIndex As Integer, _
   ByVal length As Integer _
) As Long
[C#]
public long GetBytes(
   int i,
   long dataIndex,
   byte[] buffer,
   int bufferIndex,
   int length
);
[C++]
public: __int64 GetBytes(
   int i,
   __int64 dataIndex,
   unsigned char buffer __gc[],
   int bufferIndex,
   int length
);
[JScript]
public function GetBytes(
   i : int,
   dataIndex : long,
   buffer : Byte[],
   bufferIndex : int,
   length : int
) : long;

参数

i
从零开始的列序号。
dataIndex
开始执行读操作的字段的索引。
buffer
要将字节流读入到的缓冲区。
bufferIndex
buffer 中写操作的起始位置索引。
length
要读取的字节数。

返回值

读取的实际字节数。

异常

异常类型 条件
DB2Exception 转换无效。

注释

GetBytes 返回字段中的可用字节数。大多数情况下,这是该字段的准确长度。但是,如果已使用 GetBytes 来获取字段中的字节数,那么返回的数字可能小于该字段的真实长度。例如,如果 DB2DataReader 正在将 BLOB 读入缓冲区中,那么可能存在这种情况。有关更多信息,请参阅 Microsoft(R) .NET Framework SDK 文档中 System.Data.CommandBehaviorSequentialAccess 设置。

如果传递为空值的缓冲区,那么 GetBytes 将返回字段的长度(以字节计)。

不执行转换。要检索的 数据必须为下列类型之一:
  • DB2Type.Xml
  • DB2Type.Binary
  • DB2Type.VarBinary
  • DB2Type.LongVarBinary
  • DB2Type.Blob
下表描述了返回对象数据类型与数据服务器数据类型之间的映射。
DB2Type 数据类型 DB2 数据类型 Informix 数据类型
Xml XML  
Binary BINARY 和 CHAR FOR BIT DATA  
VarBinary VARBINARY  
LongVarBinary LONG VARCHAR FOR BIT DATA  
Blob BLOB BLOB 和 BYTE