IDataRecord.GetBytes(Int32, Int64, Byte[], Int32, Int32) Метод

Определение

Пространство имен:

System.Data

Сборка:

System.Data.Common.dll

Сборка:

System.Data.dll

Сборка:

netstandard.dll

Считывает поток байтов из указанного смещения столбца в буфер в виде массива, начиная с заданного смещения буфера.

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

Количество байтов, чтение которых необходимо выполнить.

Возвращаемое значение

Int64

Число фактически считанных байтов.

Исключения

IndexOutOfRangeException

Переданный индекс находился вне диапазона от 0 до значения FieldCount.

Комментарии

GetBytes возвращает количество доступных байтов в поле. Часто это точную длину поля. Однако возвращаемое число может быть меньше истинной длины поля, если GetBytes оно уже использовалось для получения байтов из поля.

Если передать буфер null, GetBytes то возвращает длину строки в байтах.

Преобразования не выполняются; таким образом, полученные данные уже должны быть массивом байтов.