FormView.ItemInserting Event

Occurs when an Insert button within a FormView control is clicked, but before the insert operation.

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

public:
event FormViewInsertEventHandler^ ItemInserting {
	void add (FormViewInsertEventHandler^ value);
	void remove (FormViewInsertEventHandler^ value);
}
/** @event */
public void add_ItemInserting (FormViewInsertEventHandler value)

/** @event */
public void remove_ItemInserting (FormViewInsertEventHandler value)

In JScript, you can handle the events defined by a class, but you cannot define your own.
Not applicable.

The FormView control raises the ItemInserting event when an Insert button (a button with its CommandName property set to "Insert") within the control is clicked, but before the FormView control inserts the record. This allows you to provide an event-handling method that performs a custom routine, such as HTML encoding the values of a record before inserting it in the data source, whenever this event occurs.

A FormViewInsertEventArgs object is passed to the event-handling method, which allows you to determine the value of an optional command argument sent to the FormView control and to indicate that the insert operation should be canceled. The command argument value corresponds to the CommandArgument property of the Insert button. When the CommandArgument property of the Insert button is set, use the CommandArgument property to determine the value of the command argument. To cancel the insert operation, set the Cancel property to true. You can also read or modify the field values for the new record by using the Values property.

For more information about handling events, see Consuming Events.

The following example demonstrates how to use the ItemInserting event to cancel an insert operation.

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

Community Additions

ADD
Show: