DataGridViewComboBoxCell.GetFormattedValue 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得儲存格資料的格式化值。
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);
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
參數
- value
- Object
要格式化的值。
- rowIndex
- Int32
儲存格的父資料列索引。
- cellStyle
- DataGridViewCellStyle
DataGridViewCellStyle 對儲存格有作用。
- valueTypeConverter
- TypeConverter
與實值型別相關的 TypeConverter,此實值型別可提供轉換為格式化實值型別的自訂轉換作業,如果不需要這種自訂轉換,則為 null
。
- formattedValueTypeConverter
- TypeConverter
與格式化實值型別相關的 TypeConverter,此格式化實值型別可提供從實值型別轉換的自訂轉換作業,如果不需要這種自訂轉換,則為 null
。
- context
- DataGridViewDataErrorContexts
DataGridViewDataErrorContexts 值的位元 (Bitwise) 組合,其描述需要此格式化值的內容。
傳回
儲存格的資料在套用格式化之後的值;如果儲存格不是 DataGridView 控制項的一部分,則為 null
。
例外狀況
格式化失敗,而且 DataError 控制項的 DataGridView 事件沒有處理常式,或是該處理常式將 ThrowException 屬性設定為 true
。 此例外狀況物件通常可以針對型別轉換錯誤轉換成型別 FormatException,或是在 ArgumentException 或 DataSource 集合中找不到 value
時,轉換成型別 Items。
備註
控制項 DataGridView 會呼叫這個方法,將儲存格值轉換成 屬性所指示 FormattedValueType 之型別的對等顯示值。 控制項會將儲存格值傳遞至 參數中的 value
這個方法。
這個方法會先 value
判斷是否符合下列其中一個條件,判斷是否有效。
value
存在於 或 集合中 DataSourceItems 。value
是null
或 DBNull.Value。value
為 String.Empty ,而 ValueType 屬性值代表 String 類型。
如果 value
無效,就會 DataGridView.DataError 發生事件。 如果這個事件沒有處理常式,或處理常式會將 DataGridViewDataErrorEventArgs.ThrowException 屬性設定為 true
,則會擲回例外狀況。
如果 value
有效,或有 事件的處理常式 DataError ,而且它不會將 DataGridViewDataErrorEventArgs.ThrowException 屬性設定為 true
,就會 DataGridView.CellFormatting 發生此事件。
CellFormatting事件處理常式可以同時修改 value
和 cellStyle
。 不過,如果處理常式未將 DataGridViewCellFormattingEventArgs.FormattingApplied 屬性設定為 true
,則這個方法會使用 物件的格式化屬性 cellStyle
來格式化 value
。 這可能會導致額外的 DataError 事件。
如果格式化成功,這個方法會傳回控制項中顯示的 DataGridView 格式化值。
適用於
另請參閱
- FormattedValueType
- DataSource
- Items
- DataGridView
- DataGridViewCellStyle
- TypeConverter
- DataGridViewDataErrorContexts
- Format
- CellFormatting
- DataError
- GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)
- ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應