SqlDataRecord.GetBytes(Int32, Int64, Byte[], Int32, Int32) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.