Метод SqlCeDataReader.GetBytes

Статья
05/27/2011

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

Пространство имен: 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

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