Udostępnij przez


Metoda AdomdDataReader.GetChars

Zwraca tablicę Char obiektów zawierających strumienia wartości z określonej kolumna.

Przestrzeń nazw:  Microsoft.AnalysisServices.AdomdServer
Zestaw:  msmgdsrv (w msmgdsrv.dll)

Składnia

'Deklaracja
Public Function GetChars ( _
    i As Integer, _
    fieldOffset As Long, _
    buffer As Char(), _
    bufferoffset As Integer, _
    length As Integer _
) As Long
'Użycie
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

Parametry

  • i
    Typ: System.Int32
    Od zera Pozycja porządkowa kolumna, które mają zostać pobrane.
  • fieldOffset
    Typ: System.Int64
    Indeksu kolumna, z którego ma rozpocząć odczytywanie danych.
  • buffer
    Typ: array<System.Char[]
    Bufor, do którego odczytu strumienia znaków.
  • bufferoffset
    Typ: System.Int32
    Indeks od zera w buforze od rozpoczęcia zapisywania danych.
  • length
    Typ: System.Int32
    Liczba znaków do odczytu z kolumna.

Wartość zwracana

Typ: System.Int64
A długi zawiera liczbę znaków, które faktycznie odczytanych z kolumna.

Implementacje

IDataRecord.GetChars(Int32, Int64, array<Char[], Int32, Int32)

Wyjątki

Wyjątek Warunek
[IndexOutOfRangeException]

The value ofdataIndex is greater than Int32.MaxValue.

Wartość bufferIndex jest mniejsza niż 0 lub większa niż całkowita length i buffer.

Aby uzyskać więcej informacji dotyczących tego wyjątku, zobacz IndexOutOfRangeException Class.

Uwagi

GetChars Metoda zwraca liczbę znaków dostępnych pole.W większości przypadków jest to dokładną długość pole.Jednak zwrócona liczba może być mniejsza niż true długość pole Jeśli GetChars został już użyty do uzyskania znaki z pole.

W przypadku przekazania null odniesienia (nic w języku Microsoft Visual Basic) w buffer parametru GetBytes zwraca długość kolumna w znaków.

Są wykonywane nie konwersje; Dlatego dane pobierane już musi być tablicą znaków.