System.Web.UI.WebControls.DataList.OnCancelCommand Method

Raises the DataList.CancelCommand event. This allows you to provide a custom handler for the event.

Syntax

protected virtual void OnCancelCommand (DataListCommandEventArgs e)

Parameters

e
A System.Web.UI.WebControls.DataListCommandEventArgs that contains event data.

Remarks

Use the DataList.OnCancelCommand(DataListCommandEventArgs) method to provide a custom handler for the DataList.CancelCommand event.

The DataList.CancelCommand event is raised when the Cancel button is clicked for an item in the System.Web.UI.WebControls.DataList control.

A typical handler for the DataList.CancelCommand event sets the DataList.EditItemIndex property to -1 (to deselect the item) and then rebinds the data to the System.Web.UI.WebControls.DataList control.

Note:

This control can be used to display user input, which might include malicious client script. Check any information that is sent from a client for executable script, SQL statements, or other code before displaying it in your application. You can use validation controls to verify user input before displaying the input text in a control. ASP.NET provides an input request validation feature to block script and HTML in user input. For more information, see Securing Standard ControlsHow to: Protect Against Script Exploits in a Web Application by Applying HTML Encoding to Strings, and Introduction to Validating User Input in ASP.NET Web Pages.

Raising an event invokes the event handler through a delegate. For more information, see How to: Consume Events in a Web Forms Application.

The DataList.OnCancelCommand(DataListCommandEventArgs) 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.

Requirements

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in System.Web.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0