This documentation is archived and is not being maintained.

GridView::RowCancelingEdit Event

Updated: August 2008

Occurs when the Cancel button of a row in edit mode is clicked, but before the row exits edit mode.

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

public:
 event GridViewCancelEditEventHandler^ RowCancelingEdit {
	void add (GridViewCancelEditEventHandler^ value);
	void remove (GridViewCancelEditEventHandler^ value);
}
<asp:GridView OnRowCancelingEdit="GridViewCancelEditEventHandler" />

The RowCancelingEdit event is raised when the Cancel button of a row in edit mode is clicked, but before the row exits edit mode. This enables you to provide an event-handling method that performs a custom routine, such as stopping the cancel operation if it would put the row in an undesired state, whenever this event occurs.

A GridViewCancelEditEventArgs object is passed to the event-handling method, which enables you to determine the index of the current row and to indicate that the cancel operation should be stopped. To stop the cancel operation, set the Cancel property of the GridViewCancelEditEventArgs object to true.

For more information about handling events, see Consuming Events.

The following example demonstrates how to use the RowCancelingEdit event to display a cancellation message when the user cancels the update operation of a GridView control.

No code example is currently available or this language may not be supported.

The following example demonstrates how to use the RowCancelingEdit event to cancel the update operation when the data source is set programmatically.

No code example is currently available or this language may not be supported.

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

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

.NET Framework

Supported in: 3.5, 3.0, 2.0

Date

History

Reason

August 2008

Made changes to the second example.

Customer feedback.

Show: