DetailsView.ItemInserting Event

Note: This event is new in the .NET Framework version 2.0.

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

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

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

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

JScript supports the use of events, but not the declaration of new ones.

The ItemInserting event is raised when an Insert button within a DetailsView control is clicked, but before the insert operation. This allows you to provide an event handler that performs a custom routine, such as canceling the insert operation, whenever this event occurs.

A DetailsViewInsertEventArgs object is passed to the event handler, which allows you to indicate that the insert operation should be canceled. To cancel the insert operation, set the Cancel property to true. You can also manipulate the Values collection, if necessary, before the values are passed to the data source.

For more information about handling events, see Consuming Events.

The following code example demonstrates how to use the ItemInserting event to HTML-encode the values entered by the user before a new record is added to the data source.

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

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

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0

Community Additions

ADD
Show: