DataGridViewCell.GetFormattedValue 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.
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
Nilai sel yang diformat atau null
jika sel bukan milik DataGridView kontrol.
Pengecualian
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
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk