Udostępnij za pośrednictwem


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

Definicja

Odczytuje strumień bajtów z określonego przesunięcia kolumny do buforu tablicy rozpoczynającej się od danego przesunięcia 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);
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

Parametry

i
Int32

Liczba porządkowa kolumn opartych na zerach.

dataIndex
Int64

Indeks w polu, z którego ma rozpocząć operację odczytu.

buffer
Byte[]

Bufor, do którego ma być odczytywany strumień bajtów.

bufferIndex
Int32

Indeks w obszarze, w buffer którym ma być uruchamiana operacja zapisu.

length
Int32

Maksymalna długość kopiowania do buforu.

Zwraca

Rzeczywista liczba odczytanych bajtów.

Implementuje

Uwagi

GetBytes Zwraca liczbę dostępnych bajtów w polu. W większości przypadków jest to dokładna długość pola. Jednak zwrócona liczba może być 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 SqlDataReader obiekt odczytuje dużą strukturę danych do buforu. Aby uzyskać więcej informacji, zobacz SequentialAccess ustawienie dla elementu CommandBehavior.

W przypadku przekazania buforu, który jest null, GetBytes zwraca długość całego pola w bajtach, a nie pozostały rozmiar na podstawie parametru przesunięcia buforu.

Nie są wykonywane żadne konwersje; w związku z tym pobrane dane muszą już być tablicą bajtów.

Dotyczy

Zobacz też