IDataRecord.GetBytes(Int32, Int64, Byte[], Int32, Int32) 方法

定义

将字节流从指定列偏移量读入到缓冲区中,将其作为从给定缓冲区偏移量开始的数组。

public:
 long GetBytes(int i, long fieldOffset, cli::array <System::Byte> ^ buffer, int bufferoffset, int length);
public long GetBytes (int i, long fieldOffset, byte[] buffer, int bufferoffset, int length);
public long GetBytes (int i, long fieldOffset, byte[]? buffer, int bufferoffset, int length);
abstract member GetBytes : int * int64 * byte[] * int * int -> int64
Public Function GetBytes (i As Integer, fieldOffset As Long, buffer As Byte(), bufferoffset As Integer, length As Integer) As Long

参数

i
Int32

从零开始的列序号。

fieldOffset
Int64

字段中作为读取操作起始位置的索引。

buffer
Byte[]

要读入字节流的缓冲区。

bufferoffset
Int32

开始读取操作的 buffer 的索引。

length
Int32

要读取的字节数。

返回

读取的实际字节数。

例外

传递的索引位于 0 至 FieldCount 的范围之外。

注解

GetBytes 返回 字段中的可用字节数。 通常,这是字段的确切长度。 但是,如果 GetBytes 已使用 从字段获取字节,则返回的数字可能小于字段的真实长度。

如果传递的缓冲区为 nullGetBytes 则返回行的长度(以字节为单位)。

不执行任何转换;因此,检索到的数据必须已是字节数组。

适用于