Bagikan melalui


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

Definisi

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

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

Parameter

i
Int32

Ordinal kolom berbasis nol.

dataIndex
Int64

Indeks dalam bidang tempat operasi baca dimulai.

buffer
Byte[]

Buffer tempat membaca aliran byte.

bufferIndex
Int32

Indeks di buffer dalam tempat operasi tulis akan dimulai.

length
Int32

Jumlah byte yang akan dibaca.

Mengembalikan

Jumlah aktual byte yang dibaca.

Penerapan

Keterangan

GetBytes mengembalikan jumlah byte yang tersedia di bidang . Sebagian besar waktu ini adalah panjang lapangan yang tepat. Namun, angka yang dikembalikan mungkin kurang dari panjang bidang yang benar jika GetBytes telah digunakan untuk mendapatkan byte dari bidang . Ini mungkin terjadi, misalnya, jika OdbcDataReader membaca struktur data besar ke dalam buffer. Untuk informasi selengkapnya, lihat SequentialAccess pengaturan untuk CommandBehavior.

Jika Anda meneruskan buffer yang merupakan nilai null, GetBytes mengembalikan panjang bidang dalam byte.

Konversi dilakukan berdasarkan kemampuan yang mendasar dari driver ODBC. Jika konversi tidak didukung, maka panggilan metode akan gagal.

Catatan

Tidak ada pengecualian yang akan dilemparkan jika nilai bufferIndex berada di luar array. Tidak ada data yang akan dibaca dan metode akan mengembalikan 0.

Berlaku untuk

Lihat juga