SqlDataRecord.GetBytes(Int32, Int64, Byte[], Int32, Int32) Метод

Определение

Пространство имен:

Microsoft.SqlServer.Server

Сборка:

System.Data.SqlClient.dll

Пакет:

System.Data.SqlClient v4.8.5

Возвращает значение столбца, указанное порядковым номером, в виде массива объектов Byte.

public:
 virtual long GetBytes(int ordinal, long fieldOffset, cli::array <System::Byte> ^ buffer, int bufferOffset, int length);

public virtual long GetBytes (int ordinal, long fieldOffset, byte[] buffer, int bufferOffset, int length);

abstract member GetBytes : int * int64 * byte[] * int * int -> int64
override this.GetBytes : int * int64 * byte[] * int * int -> int64

Public Overridable Function GetBytes (ordinal As Integer, fieldOffset As Long, buffer As Byte(), bufferOffset As Integer, length As Integer) As Long

Параметры

ordinal

Int32

Отсчитываемый от нуля порядковый номер столбца.

fieldOffset

Int64

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

buffer

Byte[]

Целевой буфер для копирования байтов.

bufferOffset

Int32

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

length

Int32

Число байтов для копирования в буфер.

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

Int64

Скопированное число байт.

Реализации

GetBytes(Int32, Int64, Byte[], Int32, Int32)

Исключения

IndexOutOfRangeException

Значение ordinal меньше 0 или больше количества столбцов (то есть FieldCount).

SqlNullValueException

Столбец, указанный ordinal, имеет значение NULL.

InvalidCastException

Существует несоответствие типов.

Комментарии

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

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