System.Web.UI.WebControls.FormViewCommandEventHandler Delegate

Represents the method that handles the FormView.ItemCommand event of a System.Web.UI.WebControls.FormView control. This class cannot be inherited.

Syntax

public delegate void FormViewCommandEventHandler (object sender, FormViewCommandEventArgs e)

Parameters

sender
Documentation for this section has not yet been entered.
e
Documentation for this section has not yet been entered.

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 handle the events listed in the table for the operation.

When you create a System.Web.UI.WebControls.FormViewCommandEventHandler delegate, you identify the method that will handle the event. To associate the event with your event handler, add an instance of the delegate to the event. The event handler is called whenever the event occurs, unless you remove the delegate. For more information about event-handler delegates, see Events and Delegates.

Requirements

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