ListView.OnItemInserting(ListViewInsertEventArgs) Method

Definition

Raises the ItemInserting event.

protected:
 virtual void OnItemInserting(System::Web::UI::WebControls::ListViewInsertEventArgs ^ e);
protected virtual void OnItemInserting (System.Web.UI.WebControls.ListViewInsertEventArgs e);
abstract member OnItemInserting : System.Web.UI.WebControls.ListViewInsertEventArgs -> unit
override this.OnItemInserting : System.Web.UI.WebControls.ListViewInsertEventArgs -> unit
Protected Overridable Sub OnItemInserting (e As ListViewInsertEventArgs)

Parameters

e
ListViewInsertEventArgs

The event data.

Exceptions

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

Remarks

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 Handling and Raising Events.

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(ListViewInsertEventArgs) in a derived class, call the base class's OnItemInserting(ListViewInsertEventArgs) method so that registered delegates receive the event.

Applies to

See also