SqlDataReader.GetChars(Int32, Int64, Char[], Int32, Int32) Метод

Определение

Пространство имен:

Microsoft.Data.SqlClient

Сборка:

Microsoft.Data.SqlClient.dll

Пакет:

Microsoft.Data.SqlClient v5.2.0

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

public:
 override long GetChars(int i, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);

public override long GetChars (int i, long dataIndex, char[] buffer, int bufferIndex, int length);

override this.GetChars : int * int64 * char[] * int * int -> int64

Public Overrides Function GetChars (i As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As Long

Параметры

i

Int32

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

dataIndex

Int64

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

buffer

Char[]

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

bufferIndex

Int32

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

length

Int32

Максимальная длина для копирования в буфер.

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

Int64

Число фактически считанных символов.

Реализации

GetChars(Int32, Int64, Char[], Int32, Int32)

Комментарии

GetChars возвращает количество доступных символов в поле. Часто это точная длина поля. Однако возвращенное число может быть меньше фактической длины поля, если метод GetChars уже использовался для получения символов из поля. Это может быть так, например, если объект SqlDataReader считывает большую структуру данных в буфер. Дополнительные сведения см. в параметре SequentialAccess для CommandBehavior.

Фактическое число прочитанных символов может быть меньше запрошенной длины, если достигнут конец поля. Если передать буфер, равный null, GetChars возвращает длину всего поля в символах, а не оставшийся размер на основе параметра смещения буфера.

Преобразования не выполняются; Поэтому. Полученные данные уже должны быть массивом символов.

Примечание

Метод GetChars возвращает значение 0, если dataIndex имеет отрицательное значение.