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

Definition

Liest beginnend am jeweiligen Pufferoffset einen Stream von Bytes aus dem angegebenen Spaltenoffset als Array in den Puffer.

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 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.

dataIndex
Int64

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

buffer
Byte[]

Der Puffer, in den der Bytedatenstrom gelesen werden soll.

bufferIndex
Int32

Der Index im buffer, an dem der Schreibvorgang beginnen soll.

length
Int32

Die Anzahl der zu lesenden Bytes.

Gibt zurück

Die tatsächlich gelesene Anzahl von Bytes.

Implementiert

Hinweise

GetBytes gibt die Anzahl der verfügbaren Bytes im Feld zurück. In den meisten Fällen 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 OdbcDataReader große Datenstruktur in einen Puffer eingelesen wird. Weitere Informationen finden Sie in der SequentialAccess Einstellung für CommandBehavior.

Wenn Sie einen Puffer übergeben, der ein NULL-Wert ist, GetBytes gibt die Länge des Felds in Bytes zurück.

Konvertierungen werden basierend auf den zugrunde liegenden Funktionen des ODBC-Treibers durchgeführt. Wenn die Konvertierung nicht unterstützt wird, schlägt der Methodenaufruf fehl.

Hinweis

Wenn sich der Wert von außerhalb des bufferIndex Arrays befindet, wird keine Ausnahme ausgelöst. Es werden keine Daten gelesen, und die Methode gibt 0 zurück.

Gilt für:

Weitere Informationen