DataGridViewCell::EditedFormattedValue Property

 

Gets the current, formatted value of the cell, regardless of whether the cell is in edit mode and the value has not been committed.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public:
[BrowsableAttribute(false)]
property Object^ EditedFormattedValue {
	Object^ get();
}

Property Value

Type: System::Object^

The current, formatted value of the DataGridViewCell.

Exception Condition
ArgumentOutOfRangeException

The row containing the cell is a shared row.

-or-

The cell is a column header cell.

InvalidOperationException

ColumnIndex is less than 0, indicating that the cell is a row header cell.

Exception

Formatting failed and either there is no handler for the DataError event of the DataGridView control or the handler set the ThrowException property to true. The exception object can typically be cast to type FormatException.

This property returns the current value of the cell or editing control if the cell is in edit mode. Otherwise, getting the value of this property converts the cell value into an equivalent display value of the type indicated by the FormattedValueType property. This raises the DataGridView::CellFormatting event, which you can handle to customize the value conversion.

If formatting is unsuccessful, the DataGridView::DataError event occurs. If there is no handler for this event or the handler sets the DataGridViewDataErrorEventArgs::ThrowException property to true, an exception is thrown.

The following code example demonstrates how to use the EditedFormattedValue property. In this example, the IsCurrentCellDirty property is used to determine if the current cell's contents have been edited and not committed and, if the cell has been modified, the edited value is used. This example is part of a larger example available in the DataGridView::SelectionChanged event.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 2.0
Return to top
Show: