Export (0) Print
Expand All
Expand Minimize

DataGridView.NotifyCurrentCellDirty Method

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

Supported in: 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft