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

Определение

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

public:
 virtual long GetBytes(int i, long dataIndex, cli::array <System::Byte> ^ buffer, int bufferIndex, int length);
public:
 override long GetBytes(int i, long dataIndex, cli::array <System::Byte> ^ buffer, int bufferIndex, int length);
public long GetBytes(int i, long dataIndex, byte[] buffer, int bufferIndex, int length);
public override long GetBytes(int i, long dataIndex, byte[] buffer, int bufferIndex, int length);
abstract member GetBytes : int * int64 * byte[] * int * int -> int64
override this.GetBytes : int * int64 * byte[] * int * int -> int64
override this.GetBytes : int * int64 * byte[] * int * int -> int64
Public Function GetBytes (i As Integer, dataIndex As Long, buffer As Byte(), bufferIndex As Integer, length As Integer) As Long
Public Overrides Function GetBytes (i As Integer, dataIndex As Long, buffer As Byte(), bufferIndex As Integer, length As Integer) As Long

Параметры

i
Int32

Порядковый номер столбца от нуля.

dataIndex
Int64

Индекс в поле, в котором выполняется операция чтения.

buffer
Byte[]

Буфер, в который следует считывать поток байтов.

bufferIndex
Int32

Индекс в том месте buffer , где выполняется операция записи.

length
Int32

Число байтов для чтения.

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

Фактическое число операций чтения байтов.

Реализации

Комментарии

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

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

Преобразования выполняются на основе базовых возможностей драйвера ODBC. Если преобразование не поддерживается, вызов метода завершится ошибкой.

Замечание

Исключение не возникает, если значение находится за пределами bufferIndex массива. Данные не будут считываться, и метод вернет значение 0.

Применяется к

См. также раздел