SqlCeResultSet.GetBytes Method

  • Статья

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

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

Синтаксис

'Декларация
Public Overrides Function GetBytes ( _
    ordinal As Integer, _
    dataIndex As Long, _
    buffer As Byte(), _
    bufferIndex As Integer, _
    length As Integer _
) As Long

public override long GetBytes (
    int ordinal,
    long dataIndex,
    byte[] buffer,
    int bufferIndex,
    int length
)

public:
virtual long long GetBytes (
    int ordinal, 
    long long dataIndex, 
    array<unsigned char>^ buffer, 
    int bufferIndex, 
    int length
) override

public long GetBytes (
    int ordinal, 
    long dataIndex, 
    byte[] buffer, 
    int bufferIndex, 
    int length
)

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

Параметры

  • ordinal
    Порядковый номер столбца, из которого считываются данные.
  • dataIndex
    Смещение (в байтах) в поле, с которого следует начать копирование данных.
  • buffer
    Буфер, в который копируются данные.
  • bufferIndex
    Смещение в буфере, с которого начинается копирование.
  • length
    Максимальное число байтов для копирования.

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

Фактическое число байт, скопированных в буфер.

Замечания

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

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

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

Метод GetBytes может быть вызван только для столбцов базового типа binary или varbinary или к столбцов, созданных на основе объектов, которые могут быть приведены к массиву байт.

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

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

Все общие статические члены (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