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

Определение

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

public:
 override long GetChars(int ordinal, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);
public:
 virtual long GetChars(int ordinal, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);
public override long GetChars (int ordinal, long dataIndex, char[] buffer, int bufferIndex, int length);
public override long GetChars (int ordinal, long dataIndex, char[]? buffer, int bufferIndex, int length);
public long GetChars (int ordinal, long dataIndex, char[] buffer, int bufferIndex, int length);
override this.GetChars : int * int64 * char[] * int * int -> int64
abstract member GetChars : int * int64 * char[] * int * int -> int64
override this.GetChars : int * int64 * char[] * int * int -> int64
Public Overrides Function GetChars (ordinal As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As Long
Public Function GetChars (ordinal As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As Long

Параметры

ordinal
Int32

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

dataIndex
Int64

Индекс в строке, с которого начинается операция считывания.

buffer
Char[]

Буфер, в который копируются данные.

bufferIndex
Int32

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

length
Int32

Количество символов, которые необходимо считать.

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

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

Реализации

Комментарии

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

Если передать буфер , GetChars то nullвозвращает длину поля в символах.

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

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

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