Метод SqlCeDataReader.GetBytes

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

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

Синтаксис

'Декларация
<SecurityTreatAsSafeAttribute> _
<SecurityCriticalAttribute> _
Public Overrides Function GetBytes ( _
    ordinal As Integer, _
    dataIndex As Long, _
    buffer As Byte(), _
    bufferIndex As Integer, _
    length As Integer _
) As Long
'Применение
Dim instance As SqlCeDataReader
Dim ordinal As Integer
Dim dataIndex As Long
Dim buffer As Byte()
Dim bufferIndex As Integer
Dim length As Integer
Dim returnValue As Long

returnValue = instance.GetBytes(ordinal, _
    dataIndex, buffer, bufferIndex, length)
[SecurityTreatAsSafeAttribute]
[SecurityCriticalAttribute]
public override long GetBytes(
    int ordinal,
    long dataIndex,
    byte[] buffer,
    int bufferIndex,
    int length
)
[SecurityTreatAsSafeAttribute]
[SecurityCriticalAttribute]
public:
virtual long long GetBytes(
    int ordinal, 
    long long dataIndex, 
    array<unsigned char>^ buffer, 
    int bufferIndex, 
    int length
) override
[<SecurityTreatAsSafeAttribute>]
[<SecurityCriticalAttribute>]
abstract GetBytes : 
        ordinal:int * 
        dataIndex:int64 * 
        buffer:byte[] * 
        bufferIndex:int * 
        length:int -> int64 
[<SecurityTreatAsSafeAttribute>]
[<SecurityCriticalAttribute>]
override GetBytes : 
        ordinal:int * 
        dataIndex:int64 * 
        buffer:byte[] * 
        bufferIndex:int * 
        length:int -> int64 
public override function GetBytes(
    ordinal : int, 
    dataIndex : long, 
    buffer : byte[], 
    bufferIndex : int, 
    length : int
) : long

Параметры

  • ordinal
    Тип: System.Int32
    Порядковый номер столбца (от нуля).
  • dataIndex
    Тип: System.Int64
    Индекс внутри поля, с которого необходимо начать операцию считывания.
  • buffer
    Тип: array<System.Byte[]
    Буфер, в который считывается поток байтов.
  • bufferIndex
    Тип: System.Int32
    Индекс buffer для начала операции чтения.
  • length
    Тип: System.Int32
    Максимальный объем данных, который может быть скопирован в буфер.

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

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

Реализует

IDataRecord.GetBytes(Int32, Int64, array<Byte[], Int32, Int32)

Исключения

Исключение Условие
InvalidOperationException

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

Замечания

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

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

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

См. также

Справочник

SqlCeDataReader Класс

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