IDataRecord.GetChars-Methode

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

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

Syntax

'Declaration
Function GetChars ( _
    i As Integer, _
    fieldoffset As Long, _
    buffer As Char(), _
    bufferoffset As Integer, _
    length As Integer _
) As Long
'Usage
Dim instance As IDataRecord
Dim i As Integer
Dim fieldoffset As Long
Dim buffer As Char()
Dim bufferoffset As Integer
Dim length As Integer
Dim returnValue As Long

returnValue = instance.GetChars(i, fieldoffset, buffer, bufferoffset, length)

long GetChars (
    int i,
    long fieldoffset,
    char[] buffer,
    int bufferoffset,
    int length
)

long long GetChars (
    int i, 
    long long fieldoffset, 
    array<wchar_t>^ buffer, 
    int bufferoffset, 
    int length
)

long GetChars (
    int i, 
    long fieldoffset, 
    char[] buffer, 
    int bufferoffset, 
    int length
)

function GetChars (
    i : int, 
    fieldoffset : long, 
    buffer : char[], 
    bufferoffset : int, 
    length : int
) : long

Parameter

• i
  Die nullbasierte Ordnungszahl der Spalte.

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

• buffer
  Der Puffer, in den der Bytestream gelesen werden soll.

• bufferoffset
  Der Index für buffer, an dem der Lesevorgang beginnen soll.

• length
  Die Anzahl der zu lesenden Bytes.

Rückgabewert

Die tatsächlich gelesene Anzahl von Zeichen.

Ausnahmen

Ausnahmetyp	Bedingung
IndexOutOfRangeException	Der übergebene Index lag außerhalb des Bereichs von 0 (null) bis FieldCount.

Hinweise

GetChars gibt die Anzahl der verfügbaren Zeichen im Feld zurück. Häufig ist dies die genaue Länge des Felds. Die zurückgegebene Anzahl kann jedoch kleiner als die genaue Länge des Felds sein, wenn mit GetChars bereits Zeichen aus dem Feld abgerufen wurden.

Wenn Sie einen Puffer übergeben, der NULL (Nothing in Visual Basic) ist, gibt GetChars die Länge des Felds in Zeichen zurück.

Es werden keine Konvertierungen durchgeführt, daher müssen die abgerufenen Daten bereits als Zeichenarray vorliegen.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, 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, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

IDataRecord-Schnittstelle
IDataRecord-Member
System.Data-Namespace