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.