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

Definition

Liest einen Datenstrom aus dem angegebenen Spaltenoffset als Array in den Puffer, beginnend am angegebenen Pufferoffset.Reads a stream of bytes from the specified column offset into the buffer as an array, starting at the given buffer offset.

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 Spaltenordnungszahl.The zero-based column ordinal.

fieldOffset
Int64

Der Index in dem Feld, in dem der Lesevorgang beginnen soll.The index within the field from which to start the read operation.

buffer
Byte[]

Der Puffer, in den der Bytedatenstrom gelesen wird.The buffer into which to read the stream of bytes.

bufferoffset
Int32

Der Index für buffer für den Beginn des Lesevorgangs.The index for buffer to start the read operation.

length
Int32

Die Anzahl der zu lesenden Bytes.The number of bytes to read.

Gibt zurück

Die tatsächliche Anzahl gelesener Bytes.The actual number of bytes read.

Ausnahmen

Der übergebene Index lag außerhalb des Bereichs von 0 bis FieldCount.The index passed was outside the range of 0 through FieldCount.

Hinweise

GetBytes gibt die Anzahl der verfügbaren Bytes im Feld zurück.GetBytes returns the number of available bytes in the field. Dies ist häufig die genaue Länge des Felds.Frequently this is the exact length of the field. 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.However, the number returned may be less than the true length of the field if GetBytes has already been used to obtain bytes from the field.

Wenn Sie einen Puffer übergeben, der nullist, gibt GetBytes die Länge der Zeile in Bytes zurück.If you pass a buffer that is null, GetBytes returns the length of the row in bytes.

Es werden keine Konvertierungen ausgeführt. Daher müssen die abgerufenen Daten bereits ein Bytearray sein.No conversions are performed; therefore the data retrieved must already be a byte array.

Gilt für: