OdbcDataReader.GetChars(Int32, Int64, Char[], Int32, Int32) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Считывает поток символов из заданного смещения столбца в буфер в виде массива, начиная с конкретного смещения буфера.
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);
public override 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
Количество символов, которые необходимо считать.
Возвращаемое значение
Число фактически считанных символов.
Реализации
Комментарии
GetChars возвращает количество доступных символов в поле. В большинстве случаев это точная длина поля. Однако возвращенное число может быть меньше фактической длины поля, если метод GetChars уже использовался для получения символов из поля. Это может быть так, например, если объект OdbcDataReader считывает большую структуру данных в буфер. Дополнительные сведения см. в параметре SequentialAccess
для CommandBehavior.
При передаче буфера, который является значением NULL, GetChars возвращает длину поля в символах.
Преобразования выполняются на основе базовых возможностей драйвера ODBC. Если преобразование не поддерживается, вызов метода завершится ошибкой.
Примечание
Исключение не будет создано, если значение находится за пределами bufferIndex
массива. Данные не будут считываться, и метод вернет значение 0.