ListView::ItemUpdating Event

 

Occurs when an update operation is requested, but before the ListView control updates the item.

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

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

The ItemUpdating event is raised when an item's Update button is clicked or the UpdateItem method is called, but before the ListView control updates the item. (An Update button is a button control whose CommandName property is set to "Update".) This enables you to perform a custom routine whenever this event occurs, such as canceling the update operation.

A ListViewUpdateEventArgs object is passed to the event handler, which enables you to determine the index of the current item. It also lets you indicate that the update operation should be canceled. To cancel the update operation, set the Cancel property of the ListViewUpdateEventArgs object to true.

You can work with the Keys, OldValues, and NewValues collections before the values are passed to the data source. A typical way to use these collections is to HTML-encode the values supplied by the user before they are stored in the data source. This helps prevent script injection attacks.

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

The following example shows how to add an event handler for the ItemUpdating event.

System_CAPS_security Security Note

This example has a text box that accepts user input, which is a potential security threat. By default, ASP.NET Web pages validate that user input does not include script or HTML elements. For more information, see Script Exploits Overview.

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

.NET Framework
Available since 3.5
Return to top
Show: