DataGridView.NotifyCurrentCellDirty Method

Note: This method is new in the .NET Framework version 2.0.

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
)

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 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 .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0
Show: