Teilen über


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

Definition

Liest einen Datenstrom von Zeichen ab dem angegebenen Pufferoffset als Array aus dem angegebenen Spaltenoffset in den Puffer ab.

public:
 override long GetChars(int ordinal, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);
public:
 virtual long GetChars(int ordinal, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);
public override long GetChars (int ordinal, long dataIndex, char[]? buffer, int bufferIndex, int length);
public long GetChars (int ordinal, long dataIndex, char[] buffer, int bufferIndex, int length);
public override long GetChars (int ordinal, long dataIndex, char[] buffer, int bufferIndex, int length);
override this.GetChars : int * int64 * char[] * int * int -> int64
abstract member GetChars : int * int64 * char[] * int * int -> int64
override this.GetChars : int * int64 * char[] * int * int -> int64
Public Overrides Function GetChars (ordinal As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As Long
Public Function GetChars (ordinal As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As Long

Parameter

ordinal
Int32

Die nullbasierte Ordnungszahl der Spalte.

dataIndex
Int64

Der Index in der Zeile, in der der Lesevorgang beginnen soll.

buffer
Char[]

Der Puffer, in den Daten kopiert werden sollen.

bufferIndex
Int32

Der Index im buffer, an dem der Schreibvorgang beginnen soll.

length
Int32

Die Anzahl der zu lesenden Zeichen.

Gibt zurück

Die tatsächlich gelesene Anzahl von Zeichen.

Implementiert

Hinweise

GetChars gibt die Anzahl der verfügbaren Zeichen im Feld zurück. In den meisten Fällen ist dies die genaue Länge des Felds. Die zurückgegebene Zahl kann jedoch kleiner als die tatsächliche Länge des Felds sein, wenn GetChars bereits zum Abrufen von Zeichen aus dem Feld verwendet wurde. Dies kann beispielsweise der Fall sein, wenn eine OleDbDataReader große Datenstruktur in einen Puffer eingelesen wird. Weitere Informationen finden Sie in der SequentialAccess Einstellung für CommandBehavior.

Wenn Sie einen Puffer übergeben, der lautet null, GetChars gibt die Länge des Felds in Zeichen zurück.

Es werden keine Konvertierungen durchgeführt. Daher müssen die abgerufenen Daten bereits ein Zeichenarray sein.

Gilt für:

Weitere Informationen