Метод SqlCeResultSet.GetChars

Статья
05/27/2011

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

Пространство имен: 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

Поделиться через