System.Web.UI.WebControls.GridViewUpdateEventArgs Class

Provides data for the GridView.RowUpdating event.

See Also: GridViewUpdateEventArgs Members


public class GridViewUpdateEventArgs : System.ComponentModel.CancelEventArgs


The System.Web.UI.WebControls.GridView control raises the GridView.RowUpdating event when a row's Update button is clicked, but before the System.Web.UI.WebControls.GridView control updates the row. This allows you to provide an event-handling method that performs a custom routine, such as canceling the update operation, whenever this event occurs.

A System.Web.UI.WebControls.GridViewUpdateEventArgs object is passed to the event-handling method, which allows you to determine the index of the current row and to indicate that the update operation should be canceled. To cancel the update operation, set the System.ComponentModel.CancelEventArgs.Cancel property of the System.Web.UI.WebControls.GridViewUpdateEventArgs object to true. You can also manipulate the GridViewUpdateEventArgs.Keys, GridViewUpdateEventArgs.OldValues, and GridViewUpdateEventArgs.NewValues collections, if necessary, before the values are passed to the data source. A common 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 to prevent script injection attacks.

For more information about handling events, see Consuming Events.

For a list of initial property values for an instance of System.Web.UI.WebControls.GridViewUpdateEventArgs, see the GridViewSelectEventArgs.#ctor(int) constructor.


Namespace: System.Web.UI.WebControls
Assembly: System.Web (in System.Web.dll)
Assembly Versions:
Since: .NET 2.0