DataGridViewCheckBoxCell.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。

注解

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

此方法首先尝试使用 、 和 属性（如果已设置）转换为 valueBoolean 或 CheckState 值。IndeterminateValueFalseValueTrueValue

如果转换不成功，则会发生 该 DataGridView.DataError 事件。 如果此事件没有处理程序，或者处理程序将 DataGridViewDataErrorEventArgs.ThrowException 属性设置为 true，则会引发异常。

如果转换成功，或者有事件的处理程序 DataError ，并且它没有将 DataGridViewDataErrorEventArgs.ThrowException 属性设置为 true，则会发生该 DataGridView.CellFormatting 事件。

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

如果格式设置成功， context 并且参数值包含 ClipboardContent 值，此方法将 String 返回格式化值的版本，以便复制到剪贴板。 否则，此方法返回控件中显示的 DataGridView 格式化值。

适用于

另请参阅