Freigeben über


SqlDataRecord.GetBytes(Int32, Int64, Byte[], Int32, Int32) Methode

Definition

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als Array von Byte-Objekten ab.

public:
 virtual long GetBytes(int ordinal, long fieldOffset, cli::array <System::Byte> ^ buffer, int bufferOffset, int length);
public virtual long GetBytes (int ordinal, long fieldOffset, byte[] buffer, int bufferOffset, int length);
abstract member GetBytes : int * int64 * byte[] * int * int -> int64
override this.GetBytes : int * int64 * byte[] * int * int -> int64
Public Overridable Function GetBytes (ordinal As Integer, fieldOffset As Long, buffer As Byte(), bufferOffset As Integer, length As Integer) As Long

Parameter

ordinal
Int32

Die nullbasierte Ordnungszahl der Spalte.

fieldOffset
Int64

Der Offset im Feldwert, ab dem Bytes abgerufen werden sollen.

buffer
Byte[]

Der Zielpuffer, in den Bytes kopiert werden sollen.

bufferOffset
Int32

Der Offset im Puffer, ab dem Bytes kopiert werden sollen.

length
Int32

Die Anzahl von Bytes, die in den Puffer kopiert werden sollen.

Gibt zurück

Die Anzahl der kopierten Bytes.

Implementiert

Ausnahmen

ordinal ist kleiner als 0 oder größer als die Anzahl der Spalten (d. h. FieldCount).

Die durch ordinal angegebene Spalte ist 0 (null).

Es liegt ein Typenkonflikt vor.

Hinweise

Mit dieser Methode können Sie einen binärwert entweder in einem einzelnen Aufruf oder in Blöcken abrufen. Das Abrufen des Werts in Blöcken ist nützlich für große Werte oder Werte unbekannter Größe.

Um den Wert in mehreren Blöcken zu erhalten, weisen Sie ein Bytearray der Blockgröße zu, und rufen Sie wiederholt auf GetBytes , und passen Sie den fieldOffset Parameter bei jedem Aufruf entsprechend an.

Gilt für: