Share via


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

Definisi

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

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

Parameter

i
Int32

Ordinal kolom berbasis nol.

dataIndex
Int64

Indeks dalam bidang untuk memulai operasi baca.

buffer
Byte[]

Buffer tempat membaca aliran byte.

bufferIndex
Int32

Indeks di buffer dalam tempat operasi tulis akan dimulai.

length
Int32

Panjang maksimum untuk disalin ke dalam buffer.

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 SqlDataReader membaca struktur data besar ke dalam buffer. Untuk informasi selengkapnya, lihat SequentialAccess pengaturan untuk CommandBehavior.

Jika Anda melewati buffer yaitu null, GetBytes mengembalikan panjang seluruh bidang dalam byte, bukan ukuran yang tersisa berdasarkan parameter offset buffer.

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

Berlaku untuk

Lihat juga