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ären Wert entweder in einem einzelnen Aufruf oder in Blöcken abrufen. Das Abrufen des Werts in Blöcken ist für große Werte oder Werte unbekannter Größe nützlich.

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

Gilt für: