This documentation is archived and is not being maintained.

DataListCommandEventHandler Delegate

Represents the method that will handle the CancelCommand, DeleteCommand, EditCommand, ItemCommand, and UpdateCommand events of a DataList control.

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

public delegate void DataListCommandEventHandler (
	Object^ source, 
	DataListCommandEventArgs^ e
)
/** @delegate */
public delegate void DataListCommandEventHandler (
	Object source, 
	DataListCommandEventArgs e
)
JScript supports the use of delegates, but not the declaration of new ones.

Parameters

source

The source of the event.

e

A DataListCommandEventArgs that contains the event data.

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

The DeleteCommand event is raised when the Delete button for an item in the DataList control is clicked.

The EditCommand event is raised when the Edit button for an item in the DataList control is clicked.

The ItemCommand event is raised when any button for an item in the DataList control is clicked. This allows you to programmatically test for when a specific command button is clicked and take appropriate action. This event is commonly used to handle custom command buttons for the DataList control.

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

When you create a DataListCommandEventHandler delegate, you identify the method that will handle the event. To associate the event with your event handler, add an instance of the delegate to the event. The event handler is called whenever the event occurs, unless you remove the delegate. For more information about event handler delegates, see Events and Delegates.

The following example demonstrates how to define event handlers for the EditCommand, UpdateCommand, CancelCommand and DeleteCommand events of a DataList control. This example specifies the event handlers declaratively, setting the event handler for each command property on the DataList control.

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

The following code example demonstrates how to specify the event handlers and programmatically add them to the events in the Page_Load method.

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

Windows 98, Windows 2000 SP4, 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, 1.1, 1.0
Show: