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 то возвращает длину поля в символах.

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

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