OleDbDataReader.GetBytes-Methode

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

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

Syntax

'Declaration
Public Overrides Function GetBytes ( _
    ordinal As Integer, _
    dataIndex As Long, _
    buffer As Byte(), _
    bufferIndex As Integer, _
    length As Integer _
) As Long
'Usage
Dim instance As OleDbDataReader
Dim ordinal As Integer
Dim dataIndex As Long
Dim buffer As Byte()
Dim bufferIndex As Integer
Dim length As Integer
Dim returnValue As Long

returnValue = instance.GetBytes(ordinal, dataIndex, buffer, bufferIndex, length)

public override long GetBytes (
    int ordinal,
    long dataIndex,
    byte[] buffer,
    int bufferIndex,
    int length
)

public:
virtual long long GetBytes (
    int ordinal, 
    long long dataIndex, 
    array<unsigned char>^ buffer, 
    int bufferIndex, 
    int length
) override

public long GetBytes (
    int ordinal, 
    long dataIndex, 
    byte[] buffer, 
    int bufferIndex, 
    int length
)

public override function GetBytes (
    ordinal : int, 
    dataIndex : long, 
    buffer : byte[], 
    bufferIndex : int, 
    length : int
) : long

Parameter

• ordinal
  Die nullbasierte Ordnungszahl der Spalte.

• dataIndex
  Der Index im Feld, an dem der Lesevorgang beginnen soll.

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

• bufferIndex
  Der Index für buffer, an dem der Schreibvorgang beginnen soll.

• length
  Die maximal in den Puffer zu kopierende Länge.

Rückgabewert

Die tatsächlich gelesene Anzahl von Bytes.

Hinweise

GetBytes gibt die Anzahl der verfügbaren Bytes im Feld zurück. Dies 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 GetBytes bereits zum Abrufen von Bytes aus dem Feld verwendet wurde. Dies kann z. B. der Fall sein, wenn der OleDbDataReader eine umfangreiche Datenstruktur in einen Puffer liest. Weitere Informationen finden Sie unter der SequentialAccess-Einstellung für CommandBehavior.

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

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

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, 1.0

Siehe auch

Referenz

OleDbDataReader-Klasse
OleDbDataReader-Member
System.Data.OleDb-Namespace

Weitere Ressourcen

Arbeiten mit DataReaders