IDataRecord.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.
Liest einen Zeichendatenstrom aus dem angegebenen Spaltenoffset als Array in den Puffer, beginnend am angegebenen Pufferoffset.
public:
long GetChars(int i, long fieldoffset, cli::array <char> ^ buffer, int bufferoffset, int length);
public long GetChars (int i, long fieldoffset, char[] buffer, int bufferoffset, int length);
public long GetChars (int i, long fieldoffset, char[]? buffer, int bufferoffset, int length);
abstract member GetChars : int * int64 * char[] * int * int -> int64
Public Function GetChars (i As Integer, fieldoffset As Long, buffer As Char(), bufferoffset As Integer, length As Integer) As Long
Parameter
- i
- Int32
Die nullbasierte Ordnungszahl der Spalte.
- fieldoffset
- Int64
Der Index in der Zeile, in der der Lesevorgang beginnen soll.
- buffer
- Char[]
Der Puffer, in den der Bytedatenstrom gelesen werden soll.
- bufferoffset
- Int32
Der Index für buffer
für den Beginn des Lesevorgangs.
- length
- Int32
Die Anzahl der zu lesenden Bytes.
Gibt zurück
Die tatsächlich gelesene Anzahl von Zeichen.
Ausnahmen
Der übergebene Index lag außerhalb des Bereichs von 0 bis FieldCount.
Hinweise
GetChars gibt die Anzahl der verfügbaren Zeichen im Feld zurück. Häufig ist dies die genaue Länge des Felds. Die zurückgegebene Zahl kann jedoch kleiner als die genaue Länge des Felds sein, wenn GetChars
bereits zum Abrufen von Zeichen aus dem Feld verwendet wurde.
Wenn Sie einen Puffer übergeben, der lautet null
, GetChars
gibt die Länge des Felds in Zeichen zurück.
Es werden keine Umwandlungen durchgeführt, daher müssen die abgerufenen Daten bereits ein Zeichenarray bilden.