Freigeben über


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

Definition

Liest beginnend am jeweiligen Pufferoffset einen Stream von Zeichen aus dem angegebenen Spaltenoffset als Array in den Puffer.

public:
 override long GetChars(int i, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);
public:
 virtual long GetChars(int i, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);
public override long GetChars (int i, long dataIndex, char[]? buffer, int bufferIndex, int length);
public long GetChars (int i, long dataIndex, char[] buffer, int bufferIndex, int length);
public override long GetChars (int i, 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 (i As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As Long
Public Function GetChars (i As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As Long

Parameter

i
Int32

Die nullbasierte Ordnungszahl der Spalte.

dataIndex
Int64

Der Index in der Zeile, an dem 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. 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 OdbcDataReader 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 null ist, GetChars gibt die Länge des Felds in Zeichen zurück.

Konvertierungen werden basierend auf den zugrunde liegenden Funktionen des ODBC-Treibers durchgeführt. Wenn die Konvertierung nicht unterstützt wird, schlägt der Methodenaufruf fehl.

Hinweis

Es wird keine Ausnahme ausgelöst, wenn sich der Wert von bufferIndex außerhalb des Arrays befindet. Es werden keine Daten gelesen, und die Methode gibt 0 zurück.

Gilt für:

Weitere Informationen