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

Определение

Считывает поток байтов из заданного смещения столбца в буфер в виде массива, начиная с заданного смещения буфера.Reads a stream of bytes from the specified column offset into the buffer an array starting at the given buffer offset.

public:
 virtual 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);
abstract member 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

Параметры

i
Int32

Порядковый номер столбца (от нуля).The zero-based column ordinal.

dataIndex
Int64

Индекс в поле, с которого начинается операция считывания.The index within the field from which to begin the read operation.

buffer
Byte[]

Буфер, в который считывается поток байтов.The buffer into which to read the stream of bytes.

bufferIndex
Int32

Индекс в buffer, с которого должна начинаться операция записи.The index within the buffer where the write operation is to start.

length
Int32

Максимальная длина для копирования в буфер.The maximum length to copy into the buffer.

Возвраты

Число фактически считанных байтов.The actual number of bytes read.

Реализации

Комментарии

GetBytes возвращает количество доступных байтов в поле.GetBytes returns the number of available bytes in the field. В большинстве случаев это точная длина поля.Most of the time this is the exact length of the field. Однако возвращаемое число может быть меньше истинной длины поля, если GetBytes уже используется для получения байтов из поля.However, the number returned may be less than the true length of the field if GetBytes has already been used to obtain bytes from the field. Это может быть так, например, если SqlDataReader считывает структуру больших данных в буфер.This may be the case, for example, if the SqlDataReader is reading a large data structure into a buffer. Дополнительные сведения см. в описании параметра SequentialAccess для CommandBehavior.For more information, see the SequentialAccess setting for CommandBehavior.

Если передается буфер, который null, GetBytes возвращает длину всего поля в байтах, а не оставшийся размер, исходя из параметра смещения буфера.If you pass a buffer that is null, GetBytes returns the length of the entire field in bytes, not the remaining size based on the buffer offset parameter.

Преобразования не выполняются; Следовательно, извлеченные данные должны уже быть массивом байтов.No conversions are performed; therefore, the data retrieved must already be a byte array.

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

Дополнительно