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

  • Ссылка

Определение

Пространство имен:
System.Data
Сборка:
System.Data.Common.dll
Сборка:
System.Data.dll
Сборка:
netstandard.dll

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

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

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

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

Int64

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

Исключения

IndexOutOfRangeException

Переданный индекс находился вне диапазона от 0 до значения FieldCount.

Комментарии

GetChars возвращает количество доступных символов в поле. Часто это точная длина поля. Однако возвращаемое число может быть меньше точной длины поля, если GetChars оно уже использовалось для получения символов из поля.

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

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

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