SqlDataReader.GetChars(Int32, Int64, Char[], Int32, Int32) Metode

Definisi

Ruang nama:

Microsoft.Data.SqlClient

Rakitan:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

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

public:
 override long GetChars(int i, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);

public override long GetChars (int i, long dataIndex, char[] buffer, int bufferIndex, int length);

override this.GetChars : int * int64 * char[] * int * int -> int64

Public Overrides Function GetChars (i As Integer, dataIndex As Long, buffer As Char(), 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

Char[]

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

Int64

Jumlah karakter aktual yang dibaca.

Penerapan

GetChars(Int32, Int64, Char[], Int32, Int32)

Keterangan

GetChars mengembalikan jumlah karakter yang tersedia di bidang . Sering kali ini adalah panjang bidang yang tepat. Namun, angka yang dikembalikan mungkin kurang dari panjang bidang yang benar jika GetChars telah digunakan untuk mendapatkan karakter dari bidang . Ini mungkin terjadi, misalnya, jika SqlDataReader membaca struktur data besar ke dalam buffer. Untuk informasi selengkapnya, lihat SequentialAccess pengaturan untuk CommandBehavior.

Jumlah karakter aktual yang dibaca bisa kurang dari panjang yang diminta, jika akhir bidang tercapai. Jika Anda meneruskan buffer yaitu null, GetChars mengembalikan panjang seluruh bidang dalam karakter, bukan ukuran yang tersisa berdasarkan parameter offset buffer.

Tidak ada konversi yang dilakukan; Karenanya. data yang diambil harus sudah menjadi array karakter.

Catatan

Metode GetChars mengembalikan 0 ketika dataIndex negatif.