Share via

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

  • Referensi

Definisi

Ruang nama:
System.Data.SqlClient
Rakitan:
System.Data.SqlClient.dll
Rakitan:
System.Data.dll
Rakitan:
netstandard.dll, System.Data.SqlClient.dll
Paket:
System.Data.SqlClient v4.8.6

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

Berlaku untuk

Lihat juga