AdomdDataReader.GetChars-Methode

Gibt ein Array von Char-Objekten zurück, die einen Wertdatenstrom aus der angegebenen Spalte enthalten.

Namespace:  Microsoft.AnalysisServices.AdomdServer
Assembly:  msmgdsrv (in msmgdsrv.dll)

Syntax

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

Parameter

• i
  Typ: Int32
  Die nullbasierte Ordnungsposition der abzurufenden Spalte.

• fieldOffset
  Typ: Int64
  Der nullbasierte Index innerhalb der Spalte, in der mit dem Lesen von Daten begonnen wird.

• buffer
  Typ: array<Char[]
  Der Puffer, in den der Zeichendatenstrom gelesen wird.

• bufferoffset
  Typ: Int32
  Der nullbasierte Index innerhalb des Puffers, an dem mit dem Schreiben von Daten begonnen wird.

• length
  Typ: Int32
  Die Anzahl der Zeichen, die aus der Spalte gelesen werden sollen.

Rückgabewert

Typ: Int64
Ein Long-Wert, der die Anzahl der tatsächlich aus der Spalte gelesenen Zeichen enthält.

Implementiert

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

Ausnahmen

Ausnahme	Bedingung
[IndexOutOfRangeException]	Der Wert vondataIndex ist größer als Int32.MaxValue. Der Wert von bufferIndex ist kleiner als 0 oder größer als der Summe von length und die Länge von buffer. Weitere Informationen zu dieser Ausnahme finden Sie unter IndexOutOfRangeException Class.

Hinweise

Die GetChars-Methode gibt die Anzahl der verfügbaren Zeichen im Feld zurück. In den meisten Fällen ist dies die genaue Länge des Felds. Die zurückgegebene Zahl kann jedoch kleiner als die wirkliche Länge des Felds sein, wenn mit GetChars bereits Zeichen aus dem Feld abgerufen wurden.

Wenn Sie einen NULL-Verweis (Nothing in Microsoft Visual Basic) im buffer-Parameter übergeben, gibt GetBytes die Länge der Spalte in Zeichen zurück.

Es werden keine Konvertierungen ausgeführt. Daher muss es sich bei den abgerufenen Daten bereits um ein Zeichenarray handeln.

Siehe auch

Verweis

AdomdDataReader Klasse

Microsoft.AnalysisServices.AdomdServer-Namespace