OleDbDataReader.GetBytes(Int32, Int64, Byte[], Int32, Int32) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Считывает поток байтов из заданного смещения столбца в буфер в виде массива, начиная с заданного смещения буфера.
public:
override long GetBytes(int ordinal, long dataIndex, cli::array <System::Byte> ^ buffer, int bufferIndex, int length);
public:
virtual long GetBytes(int ordinal, long dataIndex, cli::array <System::Byte> ^ buffer, int bufferIndex, int length);
public override long GetBytes (int ordinal, long dataIndex, byte[]? buffer, int bufferIndex, int length);
public long GetBytes (int ordinal, long dataIndex, byte[] buffer, int bufferIndex, int length);
public override long GetBytes (int ordinal, 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 (ordinal As Integer, dataIndex As Long, buffer As Byte(), bufferIndex As Integer, length As Integer) As Long
Public Function GetBytes (ordinal As Integer, dataIndex As Long, buffer As Byte(), bufferIndex As Integer, length As Integer) As Long
Параметры
- ordinal
- Int32
Порядковый номер столбца (от нуля).
- dataIndex
- Int64
Индекс в поле, с которого необходимо начать считывание.
- buffer
- Byte[]
Буфер, в который считывается поток байтов.
- bufferIndex
- Int32
Индекс в buffer
, с которого должна начинаться операция записи.
- length
- Int32
Максимальная длина для копирования в буфер.
Возвращаемое значение
Число фактически считанных байтов.
Реализации
Комментарии
GetBytes возвращает количество доступных байтов в поле . В большинстве случаев это точная длина поля. Однако возвращаемое число может быть меньше истинной длины поля, если GetBytes
оно уже использовалось для получения байтов из поля. Это может быть так, например, когда объект OleDbDataReader считывает большую структуру данных в буфер. Дополнительные сведения см. в параметре SequentialAccess
для CommandBehavior.
При передаче буфера , равного null
, GetBytes возвращает длину поля в байтах.
Преобразования не выполняются; Таким образом, полученные данные уже должны быть массивом байтов.