IDataRecord.GetChars(Int32, Int64, Char[], Int32, Int32) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Считывает поток символов из указанного смещения столбца в буфер как массив, начиная с заданного смещения буфера.
public:
long GetChars(int i, long fieldoffset, cli::array <char> ^ buffer, int bufferoffset, int length);
public long GetChars (int i, long fieldoffset, char[] buffer, int bufferoffset, int length);
public long GetChars (int i, long fieldoffset, char[]? buffer, int bufferoffset, int length);
abstract member GetChars : int * int64 * char[] * int * int -> int64
Public Function GetChars (i As Integer, fieldoffset As Long, buffer As Char(), bufferoffset As Integer, length As Integer) As Long
Параметры
- i
- Int32
Порядковый номер столбца (от нуля).
- fieldoffset
- Int64
Индекс в строке, с которого начинается операция считывания.
- buffer
- Char[]
Буфер, в который считывается поток байтов.
- bufferoffset
- Int32
Индекс для buffer
для запуска операции чтения.
- length
- Int32
Количество байтов, чтение которых необходимо выполнить.
Возвращаемое значение
Число фактически считанных символов.
Исключения
Переданный индекс находился вне диапазона от 0 до значения FieldCount.
Комментарии
GetChars возвращает количество доступных символов в поле. Часто это точная длина поля. Однако возвращаемое число может быть меньше точной длины поля, если GetChars
оно уже использовалось для получения символов из поля.
Если передать буфер , GetChars
то null
возвращает длину поля в символах.
Преобразования не выполнены, поэтому извлеченные данные уже должны представлять из себя массив символов.