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

Definition

Liest einen Datenstrom von Bytes ab dem angegebenen Pufferoffset als Array aus dem angegebenen Spaltenoffset in den Puffer ein.Reads a stream of bytes from the specified column offset into the buffer an array starting at the given buffer offset.

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

Parameter

i
Int32

Die nullbasierte Ordnungszahl der Spalte.The zero-based column ordinal.

dataIndex
Int64

Der Index innerhalb des Felds, an dem der Lesevorgang gestartet werden soll.The index within the field from which to begin the read operation.

buffer
Byte[]

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

bufferIndex
Int32

Der Index im buffer, an dem der Schreibvorgang beginnen soll.The index within the buffer where the write operation is to start.

length
Int32

Die maximale Länge, die in den Puffer kopiert werden soll.The maximum length to copy into the buffer.

Gibt zurück

Int64

Die tatsächlich gelesene Anzahl von Bytes.The actual number of bytes read.

Implementiert

Hinweise

GetBytes Gibt die Anzahl der verfügbaren Bytes im-Feld zurück.GetBytes returns the number of available bytes in the field. In den meisten Fällen ist dies die genaue Länge des Felds.Most of the time 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. Dies kann z. b. der Fall sein, wenn SqlDataReader eine große Datenstruktur in einen Puffer liest.This may be the case, for example, if the SqlDataReader is reading a large data structure into a buffer. Weitere Informationen finden Sie unter der- SequentialAccess Einstellung für CommandBehavior .For more information, see the SequentialAccess setting for CommandBehavior.

Wenn Sie einen Puffer übergeben, null der ist, GetBytes gibt die Länge des gesamten Felds in Bytes zurück, nicht die verbleibende Größe basierend auf dem Puffer offset Parameter.If you pass a buffer that is null, GetBytes returns the length of the entire field in bytes, not the remaining size based on the buffer offset parameter.

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: