This documentation is archived and is not being maintained.

ListView.OnBubbleEvent Method

Determines whether an event for the ListView control should be handled.

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

protected override bool OnBubbleEvent(
	Object source,
	EventArgs e


Type: System.Object

The source of the event.

Type: System.EventArgs

The event data.

Return Value

Type: System.Boolean
true if the event should be handled; otherwise, false.

The OnBubbleEvent method is used by the ListView control to optionally handle events that are passed up through the control hierarchy. It determines whether to handle an event by examining the properties of the EventArgs object that are contained in the e parameter. When an event must be handled, the method performs the appropriate action. Other events are ignored and passed up the control hierarchy. The return value of this method indicates whether to handle the event or to pass the event up the control hierarchy.

The ListView control overrides the base implementation of this method to perform the appropriate action when one of the buttons that is recognized by the control is clicked. The following table lists the buttons that the ListView control recognizes.

CommandName value



Cancels an edit or insert operation. Raises the ItemCanceling event.


Deletes the current record from the data source. Raises the ItemDeleted and ItemDeleting events.


Sets the SelectedIndex property to the DisplayIndex property value for the item. Renders the SelectedItemTemplate template for the item. Raises the SelectedIndexChanging and SelectedIndexChanged events.


Puts the item in edit mode. Renders the EditItemTemplate template for the item. Raises the ItemEditing event.


Inserts the bound values from the InsertItemTemplate template into the data source. Raises the ItemInserting and ItemInserted events.


Updates the current record in the data source with the bound values from the EditItemTemplate template. Raises the ItemUpdating and ItemUpdated events.


Sorts the columns listed in the CommandArgument property of the button. Raises the Sorting and Sorted events.

This version of the method returns true if one of these buttons raises an event that is handled by the control. For more information about event bubbling, see Events and Delegates.

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5