Provides data for the FormView.ItemCommand event.
See Also: FormViewCommandEventArgs Members
Syntax
Remarks
The FormView.ItemCommand event is raised when a button within the System.Web.UI.WebControls.FormView control is clicked. This allows you to provide an event-handling method that performs a custom routine whenever this event occurs.
Buttons within a System.Web.UI.WebControls.FormView control can also invoke some of the built-in functionality of the control. To perform one of these operations, set the CommandName property of a button to one of the values in the following table.
| "Cancel" |
Cancels an edit or insert operation and returns the System.Web.UI.WebControls.FormView control to the mode specified by the FormView.DefaultMode property. Raises the FormView.ModeChanged and FormView.ModeChanging events. |
| "Delete" |
Deletes the current record. Raises the FormView.ItemDeleted and FormView.ItemDeleting events. |
| "Edit" |
Puts the System.Web.UI.WebControls.FormView control in edit mode. Raises the FormView.ModeChanged and FormView.ModeChanging events. |
| "Insert" |
Inserts the current record in the data source. Raises the FormView.ItemInserted and FormView.ItemInserting events. |
| "New" |
Puts the System.Web.UI.WebControls.FormView control in insert mode. Raises the FormView.ModeChanged and FormView.ModeChanging events. |
| "Page" |
Performs a paging operation. Set the CommandArgument property of the button to "First", "Last", "Next", "Prev", or a page number to specify the type of paging operation to perform. Raises the FormView.PageIndexChanged and FormView.PageIndexChanging events. |
| "Update" |
Updates the current record in the data source. Raises the FormView.ItemUpdated and FormView.ItemUpdating events. |
Although the FormView.ItemCommand event is raised when a button listed in the previous table is clicked, it is recommended that you use the events listed in the table for the operation.
A System.Web.UI.WebControls.FormViewCommandEventArgs object is passed to the event-handling method, which allows you to determine the command name and command argument of the button clicked. To determine the command name and command argument, use the CommandEventArgs.CommandName and CommandEventArgs.CommandArgument properties, respectively. You can also access the button control that raised the event by using the DetailsViewCommandEventArgs.CommandSource property.
For more information about handling events, see Consuming Events.
For a list of initial property values for an instance of the System.Web.UI.WebControls.FormViewCommandEventArgs class, see the FormViewCommandEventArgs.#ctor(object, CommandEventArgs) constructor.
Requirements
Assembly: System.Web (in System.Web.dll)
Assembly Versions: 2.0.0.0
Since: .NET 2.0