This documentation is archived and is not being maintained.

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
)
public void NotifyCurrentCellDirty (
	boolean dirty
)
public function NotifyCurrentCellDirty (
	dirty : boolean
)
Not applicable.

Parameters

dirty

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

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0
Show: