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

要读取的字节数。

返回值

读取的实际字节数。

异常

注释

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

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