Freigeben über


SqlDataRecord.GetChars(Int32, Int64, Char[], Int32, Int32) Methode

Definition

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als Array von Char-Objekten ab.

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

Parameter

ordinal
Int32

Die nullbasierte Ordnungszahl der Spalte.

fieldOffset
Int64

Der Offset im Feldwert, ab dem Zeichen abgerufen werden sollen.

buffer
Char[]

Der Zielpuffer, in den Zeichen kopiert werden sollen.

bufferOffset
Int32

Der Offset im Puffer, ab dem die kopierten Zeichen eingesetzt werden sollen.

length
Int32

Die Anzahl der in den Puffer zu kopierenden Zeichen.

Gibt zurück

Die Anzahl von kopierten Zeichen.

Implementiert

Ausnahmen

ordinal ist kleiner als 0 oder größer als die Anzahl der Spalten (d. h. FieldCount).

Die durch ordinal angegebene Spalte ist 0 (null).

Es liegt ein Typenkonflikt vor.

Hinweise

Mit dieser Methode können Sie einen Zeichenwert entweder in einem einzelnen Aufruf oder in Blöcken abrufen. Das Abrufen des Werts in Blöcken ist nützlich für große Werte oder Werte unbekannter Größe.

Um den Wert in mehreren Blöcken zu erhalten, weisen Sie ein Char-Array der Blockgröße zu, und rufen Sie GetChars den fieldOffset Parameter bei jedem Aufruf wiederholt an.

Gilt für: