DataGridView.OnCellMouseDown Method

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

Raises the CellMouseDown event.

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

protected virtual void OnCellMouseDown (
	DataGridViewCellMouseEventArgs e
protected void OnCellMouseDown (
	DataGridViewCellMouseEventArgs e
protected function OnCellMouseDown (
	e : DataGridViewCellMouseEventArgs



A DataGridViewCellMouseEventArgs that contains the event data.

Exception typeCondition


The value of the ColumnIndex property of e is greater than the number of columns in the control minus one.


The value of the RowIndex property of e is greater than the number of rows in the control minus one.


This action would commit a cell value or enter edit mode, but an error in the data source prevents the action and either there is no handler for the DataError event or the handler has set the DataGridViewDataErrorEventArgs.ThrowException property to true.

Raising an event invokes the event handler through a delegate. For more information, see Raising an Event.

The OnCellMouseDown method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

Notes to Inheritors When overriding OnCellMouseDown in a derived class, be sure to call the base class's OnCellMouseDown method so that registered delegates receive the event.

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