SqlCeResultSet.GetChars Method

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

Пространство имен: 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
    Смещение в буфере, с которого начинается копирование.
  • length
    Максимальное число байтов для копирования.

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

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

Замечания

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

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

Если команда выполняется в режиме SequentialAccess, то должно производиться вызовами 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

См. также

Справочник

SqlCeResultSet Class
SqlCeResultSet Members
System.Data.SqlServerCe Namespace