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