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

Определение

Считывает поток символов из указанного смещения столбца в буфер как массив, начиная с заданного смещения буфера.Reads a stream of characters from the specified column offset into the buffer as an array, starting at the given buffer offset.

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);
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

Порядковый номер столбца (начиная с нуля).The zero-based column ordinal.

fieldoffset
Int64

Индекс в строке, с которого начинается операция считывания.The index within the row from which to start the read operation.

buffer
Char[]

Буфер, в который считывается поток байтов.The buffer into which to read the stream of bytes.

bufferoffset
Int32

Индекс для buffer для запуска операции чтения.The index for buffer to start the read operation.

length
Int32

Количество байтов, чтение которых необходимо выполнить.The number of bytes to read.

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

Число фактически считанных символов.The actual number of characters read.

Исключения

Переданный индекс находился вне диапазона от 0 до значения FieldCount.The index passed was outside the range of 0 through FieldCount.

Комментарии

GetChars возвращает количество доступных символов в поле.GetChars returns the number of available characters in the field. Часто это точная длина поля.Frequently this is the exact length of the field. Однако возвращаемое число может быть меньше, чем точная длина поля, если GetChars уже использовался для получения символов из поля.However, the number returned may be less than the exact length of the field if GetChars has already been used to obtain characters from the field.

Если передается буфер, который null, GetChars возвращает длину поля в символах.If you pass a buffer that is null, GetChars returns the length of the field in characters.

Преобразования не выполнены, поэтому извлеченные данные уже должны представлять из себя массив символов.No conversions are performed; therefore the data retrieved must already be a character array.

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