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 值的按位组合,用于描述需要格式化值的上下文。
返回
应用了格式设置之后单元格数据的值;如果单元格不是 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 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈