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

Definisi

Ruang nama:

System.Data

Rakitan:

System.Data.Common.dll

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

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

Int64

Jumlah karakter aktual yang dibaca.

Pengecualian

IndexOutOfRangeException

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.