IDataRecord.GetBytes(Int32, Int64, Byte[], Int32, Int32) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
将字节流从指定列偏移量读入到缓冲区中,将其作为从给定缓冲区偏移量开始的数组。
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
已使用 从字段获取字节,则返回的数字可能小于字段的真实长度。
如果传递的缓冲区为 null
, GetBytes 则返回行的长度(以字节为单位)。
不执行任何转换;因此,检索到的数据必须已是字节数组。