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

Definisi

Ruang nama:

System.Data

Rakitan:

System.Data.Common.dll

Membaca aliran byte dari offset kolom yang ditentukan ke dalam buffer sebagai array, dimulai pada offset buffer yang diberikan.

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);

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

Parameter

i

Int32

Ordinal kolom berbasis nol.

fieldOffset

Int64

Indeks dalam bidang tempat memulai operasi baca.

buffer

Byte[]

Buffer tempat membaca aliran byte.

bufferoffset

Int32

Indeks untuk buffer memulai operasi baca.

length

Int32

Jumlah byte yang akan dibaca.

Mengembalikan

Int64

Jumlah aktual byte yang dibaca.

Pengecualian

IndexOutOfRangeException

Indeks yang diteruskan berada di luar kisaran 0 hingga FieldCount.

Keterangan

GetBytes mengembalikan jumlah byte yang tersedia di bidang . Sering kali ini adalah panjang bidang yang tepat. Namun, angka yang dikembalikan mungkin kurang dari panjang bidang yang benar jika GetBytes telah digunakan untuk mendapatkan byte dari bidang .

Jika Anda melewati buffer yaitu null, GetBytes mengembalikan panjang baris dalam byte.

Tidak ada konversi yang dilakukan; oleh karena itu data yang diambil harus sudah menjadi array byte.