DataGridView.NotifyCurrentCellDirty(Boolean) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Notifies the DataGridView that the current cell has uncommitted changes.
public:
virtual void NotifyCurrentCellDirty(bool dirty);
public virtual void NotifyCurrentCellDirty (bool dirty);
abstract member NotifyCurrentCellDirty : bool -> unit
override this.NotifyCurrentCellDirty : bool -> unit
Public Overridable Sub NotifyCurrentCellDirty (dirty As Boolean)
Parameters
- dirty
- Boolean
true
to indicate the cell has uncommitted changes; otherwise, false
.
Examples
The following code example illustrates the use of this method in a custom cell scenario. In the example, an IDataGridViewEditingControl implementation derived from the DateTimePicker class overrides the OnValueChanged method and uses the NotifyCurrentCellDirty method to indicate a change to the DataGridView control.
This example is part of a larger example shown in How to: Host Controls in Windows Forms DataGridView Cells.
protected override void OnValueChanged(EventArgs eventargs)
{
// Notify the DataGridView that the contents of the cell
// have changed.
valueChanged = true;
this.EditingControlDataGridView.NotifyCurrentCellDirty(true);
base.OnValueChanged(eventargs);
}
Protected Overrides Sub OnValueChanged(ByVal eventargs As EventArgs)
' Notify the DataGridView that the contents of the cell have changed.
valueIsChanged = True
Me.EditingControlDataGridView.NotifyCurrentCellDirty(True)
MyBase.OnValueChanged(eventargs)
End Sub
Remarks
This method can be used to allow custom cell types to notify the DataGridView when they have uncommitted changes.