ListCommandEventHandler Delegate

Definition

Caution

The System.Web.Mobile.dll assembly has been deprecated and should no longer be used. For information about how to develop ASP.NET mobile applications, see http://go.microsoft.com/fwlink/?LinkId=157231.

Represents the method that will handle the ItemCommand event of a List. For information about how to develop ASP.NET mobile applications, see Mobile Apps & Sites with ASP.NET.

public delegate void ListCommandEventHandler(object sender, ListCommandEventArgs e);
[System.Obsolete("The System.Web.Mobile.dll assembly has been deprecated and should no longer be used. For information about how to develop ASP.NET mobile applications, see http://go.microsoft.com/fwlink/?LinkId=157231.")]
public delegate void ListCommandEventHandler(object sender, ListCommandEventArgs e);

Parameters

sender
Object

The source of the event, a List control.

e
ListCommandEventArgs

A ListCommandEventArgs object that contains the event data.

Attributes

Remarks

When you create a ListCommandEventHandler delegate for a List control, you identify the method that will handle the event. The ListControl notifies the handler when an item event is generated. To associate the event with your event handler, add an instance of the delegate to the event. Unless you remove the delegate, the event handler is called whenever the event occurs.

For default rendering, the control provides a UI that allows the user to click individual list items. On postback, the control calls the OnItemCommand event handler, with an argument pointing to the source item. The value of the CommandName property is null.

When rendering with a template, the event bubbling mechanism of ASP.NET calls the OnItemCommand method. The event handler is passed a parameter, pointing to the source item, and to the CommandName property of the control that generated the event. This allows you to render a single list item with multiple associated interactions.

To render an item as a hyperlink, you can set the ItemsAsLinks property to true. The value of the Text property is used for display, and the contents of the Value property are used as the target link address when selected.

Note

Command events will not be generated for these links.

Extension Methods

GetMethodInfo(Delegate)

Gets an object that represents the method represented by the specified delegate.

Applies to

Product Versions (Obsolete)
.NET Framework 1.1, 2.0, 3.0, 3.5 (4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1)

See also