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

  • Referenz

Definition

Namespace:
System.Data
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll

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

Int64

Die tatsächlich gelesene Anzahl von Zeichen.

Ausnahmen

IndexOutOfRangeException

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.

Gilt für: