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 Datenstrom von Zeichen aus dem angegebenen Spaltenoffset in den Puffer als Array ab dem 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);abstract member GetChars : int * int64 * char[] * int * int -> int64Public Function GetChars (i As Integer, fieldoffset As Long, buffer As Char(), bufferoffset As Integer, length As Integer) As LongParameter
- i
- Int32
Die nullbasierte Spalten-Ordnungszahl.
- fieldoffset
- Int64
Der Index innerhalb der Zeile, aus der der Lesevorgang gestartet werden soll.
- buffer
- Char[]
Der Puffer, in den der Datenstrom von Bytes gelesen werden soll.
- bufferoffset
- Int32
Der Index zum buffer Starten des Lesevorgangs.
- length
- Int32
Die Anzahl der zu lesenden Bytes.
Gibt zurück
Die tatsächliche Anzahl der gelesenen Zeichen.
Ausnahmen
Der übergebene Index liegt 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 Konvertierungen ausgeführt; Daher müssen die abgerufenen Daten bereits ein Zeichenarray sein.