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