DataGridViewComboBoxCell.GetFormattedValue Metode

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Mendapatkan nilai data sel yang diformat.

protected:
 override 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 override 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);

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

Protected Overrides 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 data sel setelah pemformatan diterapkan atau null jika sel bukan bagian DataGridView dari 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 untuk kesalahan konversi jenis atau untuk mengetik ArgumentException jika value tidak dapat ditemukan di DataSource atau Items koleksi.

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 pertama-tama menentukan apakah value valid dengan menentukan apakah salah satu kondisi berikut terpenuhi.

• value ada dalam DataSource koleksi atau Items .

• value adalah null atau DBNull.Value.

• value adalah String.Empty dan ValueType nilai properti mewakili String jenis .

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

Jika value valid atau ada handler untuk DataError peristiwa dan tidak mengatur DataGridViewDataErrorEventArgs.ThrowException properti ke true, DataGridView.CellFormatting peristiwa terjadi.

Penanganan CellFormatting aktivitas dapat memodifikasi dan valuecellStyle. Jika handler tidak mengatur DataGridViewCellFormattingEventArgs.FormattingApplied properti ke true, namun, metode ini memformat value menggunakan properti cellStyle pemformatan objek. Ini dapat mengakibatkan peristiwa tambahan DataError .

Jika pemformatan berhasil, metode ini mengembalikan nilai yang diformat untuk ditampilkan dalam DataGridView kontrol.

Lihat juga

• FormattedValueType
• DataSource
• Items
• DataGridView
• DataGridViewCellStyle
• TypeConverter
• DataGridViewDataErrorContexts
• Format
• CellFormatting
• DataError
• GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)
• ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)