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

Referensi

Definisi

Ruang nama:: Microsoft.SqlServer.Server

Rakitan:: System.Data.SqlClient.dll

Rakitan:: System.Data.dll

Paket:: System.Data.SqlClient v4.8.5

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.

Mendapatkan nilai untuk kolom yang ditentukan oleh ordinal sebagai array Char objek.

public:
 virtual long GetChars(int ordinal, long fieldOffset, cli::array <char> ^ buffer, int bufferOffset, int length);

public virtual long GetChars (int ordinal, long fieldOffset, char[] buffer, int bufferOffset, int length);

abstract member GetChars : int * int64 * char[] * int * int -> int64
override this.GetChars : int * int64 * char[] * int * int -> int64

Public Overridable Function GetChars (ordinal As Integer, fieldOffset As Long, buffer As Char(), bufferOffset As Integer, length As Integer) As Long

Parameter

ordinal: Int32

Ordinal kolom berbasis nol.

fieldOffset: Int64

Offset ke dalam nilai bidang untuk mulai mengambil karakter.

buffer: Char[]

Buffer target untuk menyalin karakter.

bufferOffset: Int32

Offset ke dalam buffer untuk mulai menyalin karakter.

length: Int32

Jumlah karakter yang akan disalin ke buffer.

Mengembalikan

Int64

Jumlah karakter yang disalin.

Penerapan

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

Pengecualian

IndexOutOfRangeException

ordinal kurang dari 0 atau lebih besar dari jumlah kolom (yaitu, FieldCount).

SqlNullValueException

Kolom yang ditentukan oleh ordinal null.

InvalidCastException

Ada ketidakcocokan jenis.

Keterangan

Metode ini memungkinkan Anda untuk mendapatkan nilai karakter baik dalam satu panggilan atau dalam gugus. Mendapatkan nilai dalam gugus berguna untuk nilai besar atau nilai dengan ukuran yang tidak diketahui.

Untuk mendapatkan nilai dalam beberapa gugus, alokasikan array karakter dari ukuran gugus dan panggil GetChars berulang kali menyesuaikan fieldOffset parameter yang sesuai dalam setiap panggilan.

Berlaku untuk

Bagikan melalui