OleDbDataReader.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:
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 Spalten-Ordnungszahl.
- dataIndex
- Int64
Der Index innerhalb der Zeile, aus der der Lesevorgang gestartet werden soll.
- buffer
- Char[]
Der Puffer, in den Daten kopiert werden sollen.
- bufferIndex
- Int32
Der Index innerhalb der Stelle, an der buffer der Schreibvorgang gestartet werden soll.
- length
- Int32
Die Anzahl der zu lesenden Zeichen.
Gibt zurück
Die tatsächliche Anzahl der gelesenen Zeichen.
Implementiert
Hinweise
GetChars gibt die Anzahl der verfügbaren Zeichen im Feld zurück. Meistens 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 gelesen 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 ausgeführt; Daher müssen die abgerufenen Daten bereits ein Zeichenarray sein.