DataGridView.NotifyCurrentCellDirty Method (Boolean)

 
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.

Notifies the DataGridView that the current cell has uncommitted changes.

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

public virtual void NotifyCurrentCellDirty(
	bool dirty
)

Parameters

dirty
Type: System.Boolean

true to indicate the cell has uncommitted changes; otherwise, false.

This method can be used to allow custom cell types to notify the DataGridView when they have uncommitted changes.

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);
}

.NET Framework
Available since 2.0
Return to top
Show: