ListView::SelectedIndexChanging Event

.NET Framework (current version)

Occurs when an item's Select button is clicked, but before the ListView control handles the select operation.

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

Syntax

public:
event EventHandler<ListViewSelectEventArgs^>^ SelectedIndexChanging {
	void add(EventHandler<ListViewSelectEventArgs^>^ value);
	void remove(EventHandler<ListViewSelectEventArgs^>^ value);
}

The SelectedIndexChanging event is raised when an item's Select button is clicked, but before the ListView control handles the select operation. (A Select button is a button control whose CommandName property is set to "Select".) This enables you to perform a custom routine whenever this event occurs, such as canceling the select operation.

Note
This event is not raised when you programmatically set the SelectedIndex property.

A ListViewSelectEventArgs object is passed to the event handler, which enables you to determine the index of the item that was selected by the user. It also lets you indicate that the selection operation should be canceled. To cancel the selection operation, set the Cancel property of the ListViewSelectEventArgs object to true.

For more information about how to handle events, see NIB: Consuming Events.