Bagikan melalui


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

Definisi

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

public:
 long GetChars(int i, long fieldoffset, cli::array <char> ^ buffer, int bufferoffset, int length);
public long GetChars (int i, long fieldoffset, char[] buffer, int bufferoffset, int length);
public long GetChars (int i, long fieldoffset, char[]? buffer, int bufferoffset, int length);
abstract member GetChars : int * int64 * char[] * int * int -> int64
Public Function GetChars (i As Integer, fieldoffset As Long, buffer As Char(), bufferoffset As Integer, length As Integer) As Long

Parameter

i
Int32

Ordinal kolom berbasis nol.

fieldoffset
Int64

Indeks dalam baris tempat memulai operasi baca.

buffer
Char[]

Buffer tempat membaca aliran byte.

bufferoffset
Int32

Indeks untuk buffer memulai operasi baca.

length
Int32

Jumlah byte yang akan dibaca.

Mengembalikan

Jumlah karakter aktual yang dibaca.

Pengecualian

Indeks yang diteruskan berada di luar kisaran 0 hingga FieldCount.

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 tepat jika GetChars telah digunakan untuk mendapatkan karakter dari bidang .

Jika Anda meneruskan buffer yaitu null, GetChars mengembalikan panjang bidang dalam karakter.

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

Berlaku untuk