This documentation is archived and is not being maintained.

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)

member ItemUpdating : IEvent<EventHandler<ListViewUpdateEventArgs>,
    ListViewUpdateEventArgs>

<asp:ListView OnItemUpdating="EventHandler" />

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 Consuming Events.

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

Security noteSecurity 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

Supported in: 4, 3.5

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: