OleDbDataReader.GetChars(Int32, Int64, Char[], 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 karakter dari offset kolom yang ditentukan ke dalam buffer sebagai array yang dimulai pada offset buffer yang diberikan.
public:
override long GetChars(int ordinal, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);
public:
virtual long GetChars(int ordinal, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);
public override long GetChars (int ordinal, long dataIndex, char[]? buffer, int bufferIndex, int length);
public long GetChars (int ordinal, long dataIndex, char[] buffer, int bufferIndex, int length);
public override long GetChars (int ordinal, long dataIndex, char[] buffer, int bufferIndex, int length);
override this.GetChars : int * int64 * char[] * int * int -> int64
abstract member GetChars : int * int64 * char[] * int * int -> int64
override this.GetChars : int * int64 * char[] * int * int -> int64
Public Overrides Function GetChars (ordinal As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As Long
Public Function GetChars (ordinal As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As Long
Parameter
- ordinal
- Int32
Ordinal kolom berbasis nol.
- dataIndex
- Int64
Indeks dalam baris untuk memulai operasi baca.
- buffer
- Char[]
Buffer tempat menyalin data.
- bufferIndex
- Int32
Indeks dalam buffer
tempat operasi tulis akan dimulai.
- length
- Int32
Jumlah karakter yang akan dibaca.
Mengembalikan
Jumlah karakter aktual yang dibaca.
Penerapan
Keterangan
GetChars mengembalikan jumlah karakter yang tersedia di bidang . Sebagian besar waktu ini adalah panjang bidang yang tepat. Namun, angka yang dikembalikan mungkin kurang dari panjang benar bidang jika GetChars
telah digunakan untuk mendapatkan karakter dari bidang . Ini mungkin terjadi, misalnya, ketika OleDbDataReader membaca struktur data besar ke dalam buffer. Untuk informasi selengkapnya, lihat SequentialAccess
pengaturan untuk CommandBehavior.
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.