Метод SqlCeResultSet.GetBytes

Статья
05/27/2011

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

Пространство имен: 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
'Применение
Dim instance As SqlCeResultSet
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)

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

abstract GetBytes : 
        ordinal:int * 
        dataIndex:int64 * 
        buffer:byte[] * 
        bufferIndex:int * 
        length:int -> int64 
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
Смещение в буфере, с которого начинается копирование.

length
Тип: System.Int32
Максимальное число байтов для копирования.

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

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

Реализует

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

Замечания

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

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

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

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

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

См. также

Справочник

SqlCeResultSet Класс

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

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