SqlDataRecord.GetChars(Int32, Int64, Char[], Int32, Int32) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 -> int64Public Overridable Function GetChars (ordinal As Integer, fieldOffset As Long, buffer As Char(), bufferOffset As Integer, length As Integer) As LongParameter
- 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.