OdbcDataReader.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 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 -> int64abstract member GetChars : int * int64 * char[] * int * int -> int64
override this.GetChars : int * int64 * char[] * int * int -> int64Public Overrides Function GetChars (i As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As LongPublic Function GetChars (i As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As LongParameter
- 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.
