DataGridViewCell.GetEditedFormattedValue Method (Int32, DataGridViewDataErrorContexts)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Returns 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 object GetEditedFormattedValue(
	int rowIndex,
	DataGridViewDataErrorContexts context
)

Parameters

rowIndex
Type: System.Int32

The row index of the cell.

context
Type: System.Windows.Forms.DataGridViewDataErrorContexts

A bitwise combination of DataGridViewDataErrorContexts values that specifies the data error context.

Return Value

Type: System.Object

The current, formatted value of the DataGridViewCell.

Exception Condition
ArgumentOutOfRangeException

The specified rowIndex is less than 0 or greater than the number of rows in the control minus 1.

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 method returns the current value of the editing cell or editing control if the cell is in edit mode. Otherwise, this method 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.

Derived classes that override this method will typically return a string representation of the cell value if the context argument includes the ClipboardContent value.

.NET Framework
Available since 2.0
Return to top
Show: