SqlCeDataReader.GetChars Method

Статья
01/14/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

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

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

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

Параметры

ordinal
Порядковый номер столбца (отсчет от нуля).

dataIndex
Индекс в строке, с которого необходимо начать считывание.

buffer
Буфер, в который копируются данные.

bufferIndex
Индекс в buffer, с которого начинается операция чтения.

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

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

Действительно число считанных символов.

Исключения

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

Замечания

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

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

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

Многопоточное использование

Все общие статические члены (Shared в Microsoft Visual Basic) этого типа можно использовать в многопоточных операциях. Безопасная многопоточная работа с членами экземпляров типа не гарантируется.

Платформы

Платформы разработки

Windows Vista, Windows Mobile 5.0, Windows XP Professional with Service Pack 2 (SP2), Windows Server 2003, Windows Mobile 2003 for Pocket PC, Windows CE 5.0
Сведения о версии
.NET Framework и NET Compact Framework
Поддерживается в версии 3.5
.NET Framework
Поддерживается в версии 3.0
.NET Compact Framework и .Net Framework
Поддерживается в версии 2.0

См. также

Справочник

SqlCeDataReader Class
SqlCeDataReader Members
System.Data.SqlServerCe Namespace

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