Метод SqlCeResultSet.GetChars

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

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

Синтаксис

'Декларация
Public Overrides Function GetChars ( _
    ordinal As Integer, _
    dataIndex As Long, _
    buffer As Char(), _
    bufferIndex As Integer, _
    length As Integer _
) As Long
'Применение
Dim instance As SqlCeResultSet
Dim ordinal As Integer
Dim dataIndex As Long
Dim buffer As Char()
Dim bufferIndex As Integer
Dim length As Integer
Dim returnValue As Long

returnValue = instance.GetChars(ordinal, _
    dataIndex, buffer, bufferIndex, length)
public override long GetChars(
    int ordinal,
    long dataIndex,
    char[] buffer,
    int bufferIndex,
    int length
)
public:
virtual long long GetChars(
    int ordinal, 
    long long dataIndex, 
    array<wchar_t>^ buffer, 
    int bufferIndex, 
    int length
) override
abstract GetChars : 
        ordinal:int * 
        dataIndex:int64 * 
        buffer:char[] * 
        bufferIndex:int * 
        length:int -> int64 
override GetChars : 
        ordinal:int * 
        dataIndex:int64 * 
        buffer:char[] * 
        bufferIndex:int * 
        length:int -> int64 
public override function GetChars(
    ordinal : int, 
    dataIndex : long, 
    buffer : char[], 
    bufferIndex : int, 
    length : int
) : long

Параметры

  • ordinal
    Тип: System.Int32
    Порядковый номер поля, из которого считываются данные.
  • dataIndex
    Тип: System.Int64
    Смещение (в символах) в поле, с которого начинается копирование данных.
  • buffer
    Тип: array<System.Char[]
    Буфер, в который копируются данные.
  • bufferIndex
    Тип: System.Int32
    Смещение в буфере, с которого начинается копирование.
  • length
    Тип: System.Int32
    Максимальное число байтов для копирования.

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

Тип: System.Int64
Фактическое число скопированных символов.

Реализует

IDataRecord.GetChars(Int32, Int64, array<Char[], Int32, Int32)

Замечания

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

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

Если команда выполняется в режиме SequentialAccess, то должно производиться вызовами GetChars последовательное считывание, в противном случае возникает исключение.

Если по указанному порядковому номеру поле отсутствует, возникает исключение.

См. также

Справочник

SqlCeResultSet Класс

Пространство имен System.Data.SqlServerCe