OdbcDataReader.GetBytes(Int32, Int64, Byte[], Int32, Int32) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Odczytuje strumień bajtów z określonego przesunięcia kolumny do buforu jako tablicy, rozpoczynając od przesunięcia określonego buforu.
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);public override 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 LongParametry
- i
- Int32
Porządkowa kolumna oparta na zera.
- dataIndex
- Int64
Indeks w polu, w którym ma być uruchamiana operacja odczytu.
- buffer
- Byte[]
Bufor służący do odczytywania strumienia bajtów.
- bufferIndex
- Int32
Indeks w obszarze, w buffer którym ma być uruchamiana operacja zapisu.
- length
- Int32
Liczba bajtów do odczytania.
Zwraca
Rzeczywista liczba bajtów odczytanych.
Implementuje
Uwagi
GetBytes Zwraca liczbę dostępnych bajtów w polu. W większości przypadków jest to dokładna długość pola. Zwracana liczba może być jednak mniejsza niż rzeczywista długość pola, jeśli GetBytes została już użyta do uzyskania bajtów z pola. Może to być na przykład przypadek, jeśli odczytuje OdbcDataReader dużą strukturę danych do buforu. Aby uzyskać więcej informacji, zobacz SequentialAccess ustawienie dla CommandBehaviorelementu .
W przypadku przekazania buforu, który jest wartością null, GetBytes zwraca długość pola w bajtach.
Konwersje są wykonywane na podstawie podstawowych możliwości sterownika ODBC. Jeśli konwersja nie jest obsługiwana, wywołanie metody zakończy się niepowodzeniem.
Uwaga
Nie zostanie zgłoszony wyjątek, jeśli wartość elementu bufferIndex znajduje się poza tablicą. Nie zostaną odczytane żadne dane, a metoda zwróci wartość 0.
