Метод AdomdDataReader.GetChars

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

Пространство имен:  Microsoft.AnalysisServices.AdomdServer
Сборка:  msmgdsrv (в msmgdsrv.dll)

Синтаксис

'Декларация
Public Function GetChars ( _
    i As Integer, _
    fieldOffset As Long, _
    buffer As Char(), _
    bufferoffset As Integer, _
    length As Integer _
) As Long
'Применение
Dim instance As AdomdDataReader 
Dim i As Integer 
Dim fieldOffset As Long 
Dim buffer As Char()
Dim bufferoffset As Integer 
Dim length As Integer 
Dim returnValue As Long 

returnValue = instance.GetChars(i, fieldOffset, _
    buffer, bufferoffset, length)

public long GetChars(
    int i,
    long fieldOffset,
    char[] buffer,
    int bufferoffset,
    int length
)

public:
virtual long long GetChars(
    int i, 
    long long fieldOffset, 
    array<wchar_t>^ buffer, 
    int bufferoffset, 
    int length
) sealed

abstract GetChars : 
        i:int * 
        fieldOffset:int64 * 
        buffer:char[] * 
        bufferoffset:int * 
        length:int -> int64  
override GetChars : 
        i:int * 
        fieldOffset:int64 * 
        buffer:char[] * 
        bufferoffset:int * 
        length:int -> int64

public final function GetChars(
    i : int, 
    fieldOffset : long, 
    buffer : char[], 
    bufferoffset : int, 
    length : int
) : long

Параметры

• i
  Тип: Int32
  Порядковый номер (от нуля) столбца, из которого должны быть получены данные.

• fieldOffset
  Тип: Int64
  Индекс (от нуля) в столбце, начиная с которого должно выполняться чтение данных.

• buffer
  Тип: array<Char[]
  Буфер, в который выполняется считывание потока символов.

• bufferoffset
  Тип: Int32
  Индекс (от нуля) в буфере, начиная с которого должна выполняться запись данных.

• length
  Тип: Int32
  Число символов, которое необходимо считать из столбца.

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

Тип: Int64
Значение типа Long, содержащее число фактически считанных символов.

Реализует

IDataRecordGetChars(Int32, Int64, Char, Int32, Int32)

Исключения

Исключение	Условие
[IndexOutOfRangeException]	Значение dataIndex больше значения Int32.MaxValue. Значение bufferIndex меньше 0 или больше, чем сумма length и длины buffer. Дополнительные сведения об этом исключении см. в разделе IndexOutOfRangeException Class.

Замечания

Метод GetChars возвращает число доступных символов в поле. В большинстве случаев это точная длина поля. Тем не менее возвращенное число может быть меньше действительной длины поля, если метод GetChars уже использовался для получения символов из этого поля.

Если передается пустая ссылка (Nothing в Microsoft Visual Basic) в параметре buffer, то метод GetBytes возвращает длину столбца в символах.

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

См. также

Справочник

AdomdDataReader Класс

Пространство имен Microsoft.AnalysisServices.AdomdServer