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

Определение

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

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

public:
 virtual long GetChars(int i, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);
public:
 override long GetChars(int i, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);
public long GetChars(int i, long dataIndex, char[] buffer, int bufferIndex, int length);
public override long GetChars(int i, long dataIndex, char[] buffer, int bufferIndex, int length);
abstract member GetChars : int * int64 * char[] * int * int -> int64
override this.GetChars : int * int64 * char[] * int * int -> int64
override this.GetChars : int * int64 * char[] * int * int -> int64
Public Function GetChars (i As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As Long
Public Overrides 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 оно уже использовалось для получения символов из поля. Это может быть так, например, если в OdbcDataReader буфере считывается большая структура данных. Дополнительные сведения см. в параметре SequentialAccessCommandBehavior.

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

Преобразования выполняются на основе базовых возможностей драйвера ODBC. Если преобразование не поддерживается, вызов метода завершится ошибкой.

Замечание

Исключение не возникает, если значение находится за пределами bufferIndex массива. Данные не будут считываться, и метод вернет значение 0.

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

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