System.Web.UI.WebControls.DataList.OnUpdateCommand Method

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

Syntax

protected virtual void OnUpdateCommand (DataListCommandEventArgs e)

Parameters

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

Remarks

Use the DataList.OnUpdateCommand(DataListCommandEventArgs) method to provide a custom handler for the DataList.UpdateCommand event.

The DataList.UpdateCommand event is raised when the Update button for an item is clicked.

A typical handler for the DataList.UpdateCommand event updates the data, 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.OnUpdateCommand(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