OdbcDataReader.GetBytes(Int32, Int64, Byte[], Int32, Int32) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 -> int64abstract member GetBytes : int * int64 * byte[] * int * int -> int64
override this.GetBytes : int * int64 * byte[] * int * int -> int64Public Overrides Function GetBytes (i As Integer, dataIndex As Long, buffer As Byte(), bufferIndex As Integer, length As Integer) As LongPublic Function GetBytes (i As Integer, dataIndex As Long, buffer As Byte(), bufferIndex As Integer, length As Integer) As LongParameter
- 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. Die meiste Zeit ist die genaue Länge des Felds. Die zurückgegebene Zahl kann jedoch kleiner als die wahre 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 gelesen wird. Weitere Informationen finden Sie in der SequentialAccess Einstellung für CommandBehavior.
Wenn Sie einen Puffer übergeben, der ein Nullwert ist, GetBytes wird die Länge des Felds in Bytes zurückgegeben.
Konvertierungen werden basierend auf den zugrunde liegenden Funktionen des ODBC-Treibers ausgeführt. Wenn die Konvertierung nicht unterstützt wird, schlägt der Methodenaufruf fehl.
Hinweis
Es wird keine Ausnahme ausgelöst, wenn sich der Wert bufferIndex außerhalb des Arrays befindet. Es werden keine Daten gelesen, und die Methode gibt 0 zurück.