OdbcDataReader.GetBytes(Int32, Int64, Byte[], Int32, Int32) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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.