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

Definition

Namespace:
System.Data.SqlClient
Assembly:
System.Data.dll

Liest einen Bytestrom aus dem angegebenen Spaltenoffset in den Puffer ein Array ab dem angegebenen Pufferoffset.

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

Parameter

i
Int32

Die nullbasierte Spalten-Ordnungszahl.

dataIndex
Int64

Der Index innerhalb des Felds, aus dem der Lesevorgang gestartet werden soll.

buffer
Byte[]

Der Puffer, in den der Datenstrom von Bytes gelesen werden soll.

bufferIndex
Int32

Der Index innerhalb der Stelle, an der buffer der Schreibvorgang gestartet werden soll.

length
Int32

Die maximale Länge, die in den Puffer kopiert werden soll.

Gibt zurück

Int64

Die tatsächliche Anzahl der gelesenen Bytes.

Implementiert

GetBytes(Int32, Int64, Byte[], Int32, Int32)

Hinweise

GetBytes gibt die Anzahl der verfügbaren Bytes im Feld zurück. Meistens 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. Dies kann beispielsweise der Fall sein, wenn eine SqlDataReader große Datenstruktur in einen Puffer gelesen wird. Weitere Informationen finden Sie in der SequentialAccess Einstellung für CommandBehavior.

Wenn Sie einen Puffer nullübergeben, der lautet, GetBytes gibt die Länge des gesamten Felds in Byte und nicht die verbleibende Größe basierend auf dem Pufferoffsetparameter zurück.

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

Gilt für:

Weitere Informationen