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