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

Определение

Пространство имен:
System.Data.SqlClient
Сборка:
System.Data.SqlClient.dll
Сборка:
System.Data.dll
Исходный код:
System.Data.SqlClient.notsupported.cs

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

public:
 override long GetChars(int i, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);
public:
 virtual long GetChars(int i, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);
public override long GetChars(int i, long dataIndex, char[] buffer, int bufferIndex, int length);
public long GetChars(int i, long dataIndex, char[] buffer, int bufferIndex, int length);
override this.GetChars : int * int64 * char[] * int * int -> int64
abstract member GetChars : int * int64 * char[] * int * int -> int64
override this.GetChars : int * int64 * char[] * int * int -> int64
Public Overrides Function GetChars (i As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As Long
Public Function GetChars (i As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As Long

Параметры

i
Int32

Порядковый номер столбца от нуля.

dataIndex
Int64

Индекс в поле, с которого начинается операция чтения.

buffer
Char[]

Буфер, в который следует считывать поток байтов.

bufferIndex
Int32

Индекс в том месте buffer , где выполняется операция записи.

length
Int32

Максимальная длина для копирования в буфер.

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

Int64

Фактическое число символов, считываемых.

Реализации

GetChars(Int32, Int64, Char[], Int32, Int32)

Комментарии

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

Фактическое число операций чтения символов может быть меньше запрошенной длины, если достигается конец поля. Если вы передаете буфер null, GetChars то возвращает длину всего поля в символах, а не оставшийся размер на основе параметра смещения буфера.

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

Note

Метод GetChars возвращает значение 0 при dataIndex отрицательном значении.

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

См. также раздел