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