ListView.OnItemInserting(ListViewInsertEventArgs) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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 -> unitProtected Overridable Sub OnItemInserting (e As ListViewInsertEventArgs)Parameters
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.
