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

Определение

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

public:
 override long GetBytes(int i, long dataIndex, cli::array <System::Byte> ^ buffer, int bufferIndex, int length);
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, byte[] buffer, int bufferIndex, int length);
public override long GetBytes (int i, long dataIndex, byte[]? buffer, int bufferIndex, int length);
public long GetBytes (int i, long dataIndex, byte[] buffer, int bufferIndex, int length);
override this.GetBytes : int * int64 * byte[] * int * int -> int64
abstract member GetBytes : int * int64 * byte[] * int * int -> int64
override this.GetBytes : int * int64 * byte[] * int * int -> int64
Public Overrides Function GetBytes (i As Integer, dataIndex As Long, buffer As Byte(), bufferIndex As Integer, length As Integer) As Long
Public 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 считывает большую структуру данных в буфер. Дополнительные сведения см. в параметре SequentialAccess для CommandBehavior.

При передаче буфера, который является значением NULL, GetBytes возвращает длину поля в байтах.

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

Примечание

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

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

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