OnItemInserting Method
Collapse the table of content
Expand the table of content

ListView.OnItemInserting Method (ListViewInsertEventArgs)


Raises the ItemInserting event.

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

Protected Overridable Sub OnItemInserting (
	e As ListViewInsertEventArgs


Type: System.Web.UI.WebControls.ListViewInsertEventArgs

The event data.

Exception Condition

The ListView control is not bound to a data source control by using the DataSourceID property.

The ListView control raises the ItemInserting event when an Insert button in the control is clicked or the InsertNewItem method is called, but before the ListView control inserts the record. (An Insert button is a button control whose CommandName property is set to "Insert".) This enables you to perform a custom routine whenever this event occurs, such as HTML-encoding or validating the values of a record before it is inserted in the data source.

The OnItemInserting method is called by the ListView control to raise the ItemInserting event. It is typically used by control developers when extending the ListView class.

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

The OnItemInserting method also enables 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 you override OnItemInserting in a derived class, call the base class's OnItemInserting method so that registered delegates receive the event.

.NET Framework
Available since 3.5
Return to top
© 2015 Microsoft