SqlDataRecord.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.
Pobiera wartość kolumny określonej przez porządkową jako tablicę Byte obiektów.
public:
virtual long GetBytes(int ordinal, long fieldOffset, cli::array <System::Byte> ^ buffer, int bufferOffset, int length);public virtual long GetBytes (int ordinal, long fieldOffset, byte[] buffer, int bufferOffset, int length);abstract member GetBytes : int * int64 * byte[] * int * int -> int64
override this.GetBytes : int * int64 * byte[] * int * int -> int64Public Overridable Function GetBytes (ordinal As Integer, fieldOffset As Long, buffer As Byte(), bufferOffset As Integer, length As Integer) As LongParametry
- ordinal
- Int32
Porządkowość oparta na zerach kolumny.
- fieldOffset
- Int64
Przesunięcie do wartości pola w celu rozpoczęcia pobierania bajtów.
- buffer
- Byte[]
Bufor docelowy, do którego mają być kopiowane bajty.
- bufferOffset
- Int32
Przesunięcie do buforu, do którego chcesz rozpocząć kopiowanie bajtów.
- length
- Int32
Liczba bajtów do skopiowania do buforu.
Zwraca
Liczba skopiowanych bajtów.
Implementuje
Wyjątki
Wartość ordinal jest mniejsza niż 0 lub większa niż liczba kolumn (czyli FieldCount).
Kolumna określona przez ordinal ma wartość null.
Wystąpiła niezgodność typów.
Uwagi
Ta metoda umożliwia uzyskanie wartości binarnej w jednym wywołaniu lub we fragmentach. Pobieranie wartości we fragmentach jest przydatne w przypadku dużych wartości lub wartości nieznanego rozmiaru.
Aby uzyskać wartość w kilku fragmentach, przydziel tablicę bajtów rozmiaru fragmentu i GetBytes wywołaj wielokrotnie, dostosowując fieldOffset parametr odpowiednio w każdym wywołaniu.