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 то возвращает длину строки в байтах.
Преобразование не выполняется; поэтому полученные данные уже должны быть массивом байтов.