DataGridViewComboBoxCell.GetFormattedValue 方法

  • 参考

定义

命名空间:
System.Windows.Forms
程序集:
System.Windows.Forms.dll

获取单元格数据的格式化值。

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 值的按位组合，用于描述需要格式化值的上下文。

返回

Object

应用了格式设置之后单元格数据的值；如果单元格不是 DataGridView 控件的一部分，则为 null。

例外

Exception

格式化失败，这是由于 DataError 控件的 DataGridView 事件无处理程序或处理程序将 ThrowException 属性设置为 true 而引起的。 出现类型转换错误时，通常可以将异常对象强制转换为类型 FormatException，或者当无法在 ArgumentException 或 DataSource 集合中找到 value 时，将异常对象强制转换为类型 Items。

注解

控件 DataGridView 调用此方法可将单元格值转换为 属性指示 FormattedValueType 的 类型的等效显示值。 控件将单元格值传递到 参数中的 value 此方法。

此方法首先通过确定是否 value 满足以下条件之一来确定是否有效。

如果 value 无效，则发生 事件 DataGridView.DataError 。 如果此事件没有处理程序，或者处理程序将 DataGridViewDataErrorEventArgs.ThrowException 属性设置为 true，则会引发异常。

如果 value 有效或事件有处理程序 DataError ，并且它未将 DataGridViewDataErrorEventArgs.ThrowException 属性设置为 true，则会发生该 DataGridView.CellFormatting 事件。

CellFormatting事件处理程序可以修改 value 和 cellStyle。 但是，如果处理程序未将 DataGridViewCellFormattingEventArgs.FormattingApplied 属性设置为 true，则此方法使用 对象的格式设置属性cellStyle进行格式value设置。 这可能会导致额外的 DataError 事件。

如果格式设置成功，此方法返回控件中 DataGridView 显示的格式化值。

适用于

另请参阅