DataGridViewCell.GetFormattedValue Metode

Referensi

Definisi

Ruang nama:: System.Windows.Forms

Rakitan:: System.Windows.Forms.dll

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 sel seperti yang diformat untuk ditampilkan.

protected:
 virtual System::Object ^ GetFormattedValue(System::Object ^ value, int rowIndex, System::Windows::Forms::DataGridViewCellStyle ^ % cellStyle, System::ComponentModel::TypeConverter ^ valueTypeConverter, System::ComponentModel::TypeConverter ^ formattedValueTypeConverter, System::Windows::Forms::DataGridViewDataErrorContexts context);

protected virtual object GetFormattedValue (object value, int rowIndex, ref System.Windows.Forms.DataGridViewCellStyle cellStyle, System.ComponentModel.TypeConverter valueTypeConverter, System.ComponentModel.TypeConverter formattedValueTypeConverter, System.Windows.Forms.DataGridViewDataErrorContexts context);

protected virtual object? GetFormattedValue (object? value, int rowIndex, ref System.Windows.Forms.DataGridViewCellStyle cellStyle, System.ComponentModel.TypeConverter? valueTypeConverter, System.ComponentModel.TypeConverter? formattedValueTypeConverter, System.Windows.Forms.DataGridViewDataErrorContexts context);

abstract member GetFormattedValue : obj * int * DataGridViewCellStyle * System.ComponentModel.TypeConverter * System.ComponentModel.TypeConverter * System.Windows.Forms.DataGridViewDataErrorContexts -> obj
override this.GetFormattedValue : obj * int * DataGridViewCellStyle * System.ComponentModel.TypeConverter * System.ComponentModel.TypeConverter * System.Windows.Forms.DataGridViewDataErrorContexts -> obj

Protected Overridable Function GetFormattedValue (value As Object, rowIndex As Integer, ByRef cellStyle As DataGridViewCellStyle, valueTypeConverter As TypeConverter, formattedValueTypeConverter As TypeConverter, context As DataGridViewDataErrorContexts) As Object

Parameter

value: Object

Nilai yang akan diformat.

rowIndex: Int32

Indeks baris induk sel.

cellStyle: DataGridViewCellStyle

Efek DataGridViewCellStyle untuk sel.

valueTypeConverter: TypeConverter

Yang TypeConverter terkait dengan jenis nilai yang menyediakan konversi kustom ke jenis nilai yang diformat, atau null jika tidak diperlukan konversi kustom tersebut.

formattedValueTypeConverter: TypeConverter

Yang TypeConverter terkait dengan jenis nilai yang diformat yang menyediakan konversi kustom dari jenis nilai, atau null jika tidak diperlukan konversi kustom tersebut.

context: DataGridViewDataErrorContexts

Kombinasi DataGridViewDataErrorContexts nilai bitwise yang menjelaskan konteks di mana nilai yang diformat diperlukan.

Mengembalikan

Object

Nilai sel yang diformat atau null jika sel bukan milik DataGridView kontrol.

Pengecualian

Exception

Pemformatan gagal dan tidak ada handler untuk DataError peristiwa kontrol atau handler mengatur properti ke ThrowExceptiontrue.DataGridView Objek pengecualian biasanya dapat dilemparkan ke jenis FormatException.

Keterangan

Kontrol DataGridView memanggil metode ini untuk mengonversi nilai sel menjadi nilai tampilan yang setara dari jenis yang ditunjukkan FormattedValueType oleh properti . Kontrol meneruskan nilai sel ke metode ini dalam value parameter .

Metode ini meningkatkan DataGridView.CellFormatting peristiwa. Handler untuk kejadian ini dapat memodifikasi value parameter dan cellStyle . Jika handler tidak mengatur DataGridViewCellFormattingEventArgs.FormattingApplied properti ke true, namun, metode ini memformat value menggunakan properti cellStyle pemformatan objek.

Catatan

Metode ini tidak mengonversi value ke DataGridViewCellStyle.NullValue nilai properti untuk nilai yang sama dengan DataGridViewCellStyle.DataSourceNullValue nilai properti ketika DataSourceNullValue diatur ke nilai selain DBNull.Value atau null. Dalam hal ini, Anda dapat menangani DataGridView.CellFormatting peristiwa untuk menampilkan NullValue nilai properti. Untuk informasi selengkapnya, lihat contoh kode di DataSourceNullValue.

Jika pemformatan tidak berhasil, peristiwa terjadi DataError . Jika tidak ada handler untuk kejadian ini atau handler mengatur DataGridViewDataErrorEventArgs.ThrowException properti ke true, pengecualian akan dilemparkan.

Kelas turunan yang mengambil alih metode ini biasanya akan mengembalikan representasi string dari nilai sel jika context argumen menyertakan ClipboardContent nilai .

Berlaku untuk

Share via