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

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Data
Zestaw:
System.Data.Common.dll
Zestaw:
System.Data.dll
Zestaw:
netstandard.dll

Odczytuje strumień bajtów z określonego przesunięcia kolumny do buforu jako tablicy, rozpoczynając od danego przesunięcia buforu.

public:
 long GetBytes(int i, long fieldOffset, cli::array <System::Byte> ^ buffer, int bufferoffset, int length);
public long GetBytes (int i, long fieldOffset, byte[] buffer, int bufferoffset, int length);
public long GetBytes (int i, long fieldOffset, byte[]? buffer, int bufferoffset, int length);
abstract member GetBytes : int * int64 * byte[] * int * int -> int64
Public Function GetBytes (i As Integer, fieldOffset As Long, buffer As Byte(), bufferoffset As Integer, length As Integer) As Long

Parametry

i
Int32

Porządkowa kolumna oparta na zera.

fieldOffset
Int64

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

buffer
Byte[]

Bufor służący do odczytywania strumienia bajtów.

bufferoffset
Int32

Indeks umożliwiający buffer rozpoczęcie operacji odczytu.

length
Int32

Liczba bajtów do odczytania.

Zwraca

Int64

Rzeczywista liczba bajtów odczytanych.

Wyjątki

IndexOutOfRangeException

Przekazany indeks był poza zakresem od 0 do FieldCount.

Uwagi

GetBytes Zwraca liczbę dostępnych bajtów w polu. Często 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.

W przypadku przekazania buforu, który jest null, GetBytes zwraca długość wiersza w bajtach.

Nie są wykonywane żadne konwersje; dlatego pobrane dane muszą być już tablicą bajtów.

Dotyczy