Bagikan melalui

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

  • Referensi

Definisi

Ruang nama:
System.Data.Odbc
Rakitan:
System.Data.Odbc.dll
Rakitan:
System.Data.dll
Paket:
System.Data.Odbc v8.0.1
Paket:
System.Data.Odbc v9.0.0-rc.2.24473.5
Sumber:
OdbcDataReader.cs
Sumber:
OdbcDataReader.cs

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

public:
 override long GetChars(int i, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);
public:
 virtual 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);
public long GetChars (int i, long dataIndex, 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
abstract member GetChars : int * int64 * char[] * int * int -> int64
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
Public 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 baris tempat operasi baca akan dimulai.

buffer
Char[]

Buffer tempat menyalin data.

bufferIndex
Int32

Indeks dalam buffer tempat operasi tulis akan dimulai.

length
Int32

Jumlah karakter yang akan dibaca.

Mengembalikan

Int64

Jumlah karakter aktual yang dibaca.

Penerapan

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

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

Jika Anda meneruskan buffer yang merupakan nilai null, GetChars mengembalikan panjang bidang dalam karakter.

Konversi dilakukan berdasarkan kemampuan yang mendasar dari driver ODBC. Jika konversi tidak didukung, maka panggilan metode akan gagal.

Catatan

Tidak ada pengecualian yang akan dilemparkan jika nilai bufferIndex berada di luar array. Tidak ada data yang akan dibaca dan metode akan mengembalikan 0.

Berlaku untuk

Lihat juga