DataGrid.OnUpdateCommand Method

Raises the UpdateCommand event. This allows you to provide a custom handler for the event.

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

protected:
virtual void OnUpdateCommand (
	DataGridCommandEventArgs^ e
)
protected void OnUpdateCommand (
	DataGridCommandEventArgs e
)
protected function OnUpdateCommand (
	e : DataGridCommandEventArgs
)
Not applicable.

Parameters

e

A DataGridCommandEventArgs that contains event data.

Use the OnUpdateCommand method to provide a custom handler for the UpdateCommand event.

The UpdateCommand event is raised when the Update button for an item is clicked.

A typical handler for the UpdateCommand event updates the data, sets the EditItemIndex property to -1 (to deselect the item), and then rebinds the data to the DataGrid control.

Caution noteCaution:

Text is not HTML encoded before it is displayed in the DataGrid control. If the values for the control come from user input, be sure to validate the values to reduce security vulnerabilities.

Raising an event invokes the event handler through a delegate. For more information, see Raising an Event.

The OnUpdateCommand method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

Notes to Inheritors: When overriding OnUpdateCommand in a derived class, be sure to call the base class's OnUpdateCommand method so that registered delegates receive the event.

The following code example demonstrates how to specify and code a handler for the UpdateCommand event to update the values of an item in the DataGrid control to new values specified by the user.

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

Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

Community Additions

ADD
Show: