GetBytes-Methode

Liest einen Bytestrom aus dem angegebenen Spaltenoffset in den Puffer als Array ein und beginnt dabei am angegebenen Pufferoffset.

Syntax

Visual Basic

Public Overrides Function GetBytes( _
   ByVal ordinal As Integer, _
   ByVal dataIndex As Long, _
   ByVal buffer As Byte(), _
   ByVal bufferIndex As Integer, _
   ByVal length As Integer _
) As Long

C#

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

Parameter

ordinal Eine Ordinalzahl, die die Spalte angibt, aus der der Wert bezogen wurde. Die Nummerierung erfolgt auf Nullbasis.
dataIndex Der Index innerhalb des Spaltenwerts, aus dem Byte ausgelesen werden.
buffer Ein Array, in dem Daten gespeichert werden.
bufferIndex Der Index im Array zum Beginn des Kopierens von Daten.
length Die maximale Länge der Daten, die in den angegebenen Puffer kopiert werden sollen

Rückgabewert

Die Anzahl der gelesenen Byte

Bemerkungen

GetBytes gibt die Anzahl der verfügbaren Byte im Feld zurück. In den meisten Fällen ist dies die exakte Länge des Feldes. Allerdings kann die zurückgegebene Zahl geringer sein als die wahre Länge des Feldes, wenn GetBytes bereits benutzt wurde, um Byte aus dem Feld abzurufen. Dies kann beispielsweise vorkommen, wenn das SADataReader-Objekt eine umfangreiche Datenstruktur in den Puffer einliest.

Wenn Sie einen Puffer übergeben, der eine Nullreferenz ist ("Nothing" in Visual Basic), gibt GetBytes die Länge des Feldes in Byte zurück.

Es werden keine Konvertierungen durchgeführt, daher müssen die abgerufenen Daten als Byte-Array vorliegen.

Siehe auch

Kommentieren Sie diese Seite in DocCommentXchange.
Senden Sie uns Feedback über diese Seite via E-Mail.