OdbcDataReader.GetChars-Methode

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

Namespace: System.Data.Odbc
Assembly: System.Data (in system.data.dll)

Syntax

'Declaration
Public Overrides Function GetChars ( _
    i As Integer, _
    dataIndex As Long, _
    buffer As Char(), _
    bufferIndex As Integer, _
    length As Integer _
) As Long
'Usage
Dim instance As OdbcDataReader
Dim i As Integer
Dim dataIndex As Long
Dim buffer As Char()
Dim bufferIndex As Integer
Dim length As Integer
Dim returnValue As Long

returnValue = instance.GetChars(i, dataIndex, buffer, bufferIndex, length)

public override long GetChars (
    int i,
    long dataIndex,
    char[] buffer,
    int bufferIndex,
    int length
)

public:
virtual long long GetChars (
    int i, 
    long long dataIndex, 
    array<wchar_t>^ buffer, 
    int bufferIndex, 
    int length
) override

public long GetChars (
    int i, 
    long dataIndex, 
    char[] buffer, 
    int bufferIndex, 
    int length
)

public override function GetChars (
    i : int, 
    dataIndex : long, 
    buffer : char[], 
    bufferIndex : int, 
    length : int
) : long

Parameter

• i
  Die nullbasierte Ordnungszahl der Spalte.

• dataIndex
  Der Index in der Zeile, an dem der Lesevorgang beginnen soll.

• buffer
  Der Puffer, in den Daten kopiert werden sollen.

• bufferIndex
  Der Index, an dem buffer mit dem Schreibvorgang beginnen soll.

• length
  Die Anzahl der zu lesenden Zeichen.

Rückgabewert

Die tatsächlich gelesene Anzahl von Zeichen.

Hinweise

GetChars gibt die Anzahl der verfügbaren Zeichen im Feld zurück. Das entspricht in den meisten Fällen der genauen Länge des Felds. Die zurückgegebene Anzahl 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 z. B. der Fall sein, wenn der OdbcDataReader eine umfangreiche Datenstruktur in einen Puffer liest. Weitere Informationen finden Sie unter der SequentialAccess-Einstellung für CommandBehavior.

Wenn Sie als Puffer einen NULL-Wert übergeben, gibt GetChars die Länge des Felds in Zeichen zurück.

Konvertierungen werden entsprechend den zugrunde liegenden Fähigkeiten des ODBC-Treibers ausgeführt. Wenn die Konvertierung nicht unterstützt wird, schlägt die Methode fehl.

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1

Siehe auch

Referenz

OdbcDataReader-Klasse
OdbcDataReader-Member
System.Data.Odbc-Namespace

Weitere Ressourcen

Arbeiten mit DataReaders