Метод SqlCeDataReader.GetChars

Статья
05/27/2011

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

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

Синтаксис

'Декларация
<SecurityTreatAsSafeAttribute> _
<SecurityCriticalAttribute> _
Public Overrides Function GetChars ( _
    ordinal As Integer, _
    dataIndex As Long, _
    buffer As Char(), _
    bufferIndex As Integer, _
    length As Integer _
) As Long
'Применение
Dim instance As SqlCeDataReader
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)

[SecurityTreatAsSafeAttribute]
[SecurityCriticalAttribute]
public override long GetChars(
    int ordinal,
    long dataIndex,
    char[] buffer,
    int bufferIndex,
    int length
)

[SecurityTreatAsSafeAttribute]
[SecurityCriticalAttribute]
public:
virtual long long GetChars(
    int ordinal, 
    long long dataIndex, 
    array<wchar_t>^ buffer, 
    int bufferIndex, 
    int length
) override

[<SecurityTreatAsSafeAttribute>]
[<SecurityCriticalAttribute>]
abstract GetChars : 
        ordinal:int * 
        dataIndex:int64 * 
        buffer:char[] * 
        bufferIndex:int * 
        length:int -> int64 
[<SecurityTreatAsSafeAttribute>]
[<SecurityCriticalAttribute>]
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
Индекс buffer для начала операции чтения.

length
Тип: System.Int32
Число символов, которые должны быть считаны.

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

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

Реализует

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

Исключения

Исключение	Условие
InvalidOperationException	Недопустимая операция. Объект SqlCeDataReader может располагаться за последней строкой в результирующем наборе.

Замечания

Метод GetChars возвращает число символов, содержащихся в поле. В большинстве случаев это точная длина поля. Возвращенное число может быть меньше реальной длины поля, если считывание символов из поля уже производилось методом GetChars. Например, это может произойти, когда SqlCeDataReader считывает в буфер большую структуру данных. Дополнительные сведения см. в параметре SequentialAccess для класса CommandBehavior.

Если передать буфер со значением nullпустая ссылка (Nothing в Visual Basic), метод GetChars возвратит длину поля в символах.

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

См. также

Справочник

SqlCeDataReader Класс

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

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