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

Definition

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Liest einen Datenstrom aus dem angegebenen Spaltenoffset als Array in den Puffer, beginnend am angegebenen Pufferoffset.

public:
 long GetBytes(int i, long fieldOffset, cli::array <System::Byte> ^ buffer, int bufferoffset, int length);

public long GetBytes (int i, long fieldOffset, byte[]? buffer, int bufferoffset, int length);

abstract member GetBytes : int * int64 * byte[] * int * int -> int64

Public Function GetBytes (i As Integer, fieldOffset As Long, buffer As Byte(), bufferoffset As Integer, length As Integer) As Long

Parameter

i

Int32

Die nullbasierte Ordnungszahl der Spalte.

fieldOffset

Int64

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

buffer

Byte[]

Der Puffer, in den der Bytedatenstrom gelesen werden soll.

bufferoffset

Int32

Der Index für buffer für den Beginn des Lesevorgangs.

length

Int32

Die Anzahl der zu lesenden Bytes.

Gibt zurück

Int64

Die tatsächlich gelesene Anzahl von Bytes.

Ausnahmen

IndexOutOfRangeException

Der übergebene Index lag außerhalb des Bereichs von 0 bis FieldCount.

Hinweise

GetBytes gibt die Anzahl der verfügbaren Bytes im Feld zurück. Häufig ist dies die genaue Länge des Felds. Die zurückgegebene Zahl kann jedoch kleiner als die tatsächliche Länge des Felds sein, wenn GetBytes bereits zum Abrufen von Bytes aus dem Feld verwendet wurde.

Wenn Sie einen Puffer übergeben, der lautet null, GetBytes gibt die Länge der Zeile in Bytes zurück.

Es werden keine Konvertierungen durchgeführt. Daher müssen die abgerufenen Daten bereits ein Bytearray sein.