DataGridViewCell.GetEditedFormattedValue 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
返回该单元格的当前格式化值,而不考虑该单元格是否处于编辑模式,也无论是否尚未提交此值。
public:
System::Object ^ GetEditedFormattedValue(int rowIndex, System::Windows::Forms::DataGridViewDataErrorContexts context);
public object GetEditedFormattedValue (int rowIndex, System.Windows.Forms.DataGridViewDataErrorContexts context);
public object? GetEditedFormattedValue (int rowIndex, System.Windows.Forms.DataGridViewDataErrorContexts context);
member this.GetEditedFormattedValue : int * System.Windows.Forms.DataGridViewDataErrorContexts -> obj
Public Function GetEditedFormattedValue (rowIndex As Integer, context As DataGridViewDataErrorContexts) As Object
参数
- rowIndex
- Int32
单元格的行索引。
- context
- DataGridViewDataErrorContexts
DataGridViewDataErrorContexts 值的按位组合,用于指定数据错误上下文。
返回
DataGridViewCell 的当前格式化值。
例外
指定的 rowIndex
小于 0,或大于控件中的行数减 1。
ColumnIndex 小于 0,这表示该单元格为行标头单元格。
格式化失败,这是由于 DataError 控件的 DataGridView 事件无处理程序或处理程序将 ThrowException 属性设置为 true
而引起的。 通常情况下,可将该异常对象强制转换为类型 FormatException。
注解
如果单元格处于编辑模式,则此方法返回编辑单元格或编辑控件的当前值。 否则,此方法会将单元格值转换为 属性指示 FormattedValueType 的 类型的等效显示值。 这会引发 DataGridView.CellFormatting 事件,你可以处理该事件来自定义值转换。
如果格式设置不成功,则会发生 该 DataGridView.DataError 事件。 如果此事件没有处理程序,或者处理程序将 DataGridViewDataErrorEventArgs.ThrowException 属性设置为 true
,则会引发异常。
如果 context
参数包含 ClipboardContent 值,重写此方法的派生类通常会返回单元格值的字符串表示形式。