SqlCeDataReader.GetBytes Method

Статья
01/14/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

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
Индекс в buffer, с которого начинается операция чтения.

length
Максимальный объем данных, который может быть скопирован в буфер.

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

Действительное число считанных байтов.

Исключения

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

Замечания

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

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

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

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

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

См. также

Справочник

SqlCeDataReader Class
SqlCeDataReader Members
System.Data.SqlServerCe Namespace

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