SqlDataRecord.GetChars(Int32, Int64, Char[], Int32, Int32) Метод

Ссылка

Определение

Пространство имен:: Microsoft.SqlServer.Server

Сборка:: System.Data.SqlClient.dll

Сборка:: System.Data.dll

Пакет:: System.Data.SqlClient v4.8.5

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

public:
 virtual long GetChars(int ordinal, long fieldOffset, cli::array <char> ^ buffer, int bufferOffset, int length);

public virtual long GetChars (int ordinal, long fieldOffset, char[] buffer, int bufferOffset, int length);

abstract member GetChars : int * int64 * char[] * int * int -> int64
override this.GetChars : int * int64 * char[] * int * int -> int64

Public Overridable Function GetChars (ordinal As Integer, fieldOffset As Long, buffer As Char(), bufferOffset As Integer, length As Integer) As Long

Параметры

ordinal: Int32

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

fieldOffset: Int64

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

buffer: Char[]

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

bufferOffset: Int32

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

length: Int32

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

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

Int64

Число скопированных символов.

Реализации

GetChars(Int32, Int64, Char[], Int32, Int32)

Исключения

IndexOutOfRangeException

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

SqlNullValueException

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

InvalidCastException

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

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

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

Применяется к