ItemInserted Event

ListView::ItemInserted Event


Occurs when an insert operation is requested, after the ListView control has inserted the item in the data source.

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

event EventHandler<ListViewInsertedEventArgs^>^ ItemInserted {
	void add(EventHandler<ListViewInsertedEventArgs^>^ value);
	void remove(EventHandler<ListViewInsertedEventArgs^>^ value);

The ListView control raises the ItemInserted event when an Insert button in the InsertItemTemplate template is clicked or the InsertNewItem method is called, after the ListView control inserts the item in the data source. (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 checking the results of an insert operation.

A ListViewInsertedEventArgs object is passed to the event handler, which enables you to determine the number of records affected. It also lets you determine what exceptions might have occurred. To determine the number of records that were affected by the insert operation, use the AffectedRows property. To determine whether any exceptions occurred, use the Exception property. You can also indicate whether the exception was handled in the event handler by setting the ExceptionHandled property. If you want to access the values of the inserted record, use the Values property.

If the AffectedRows property reports that no items were inserted, you can rebind the insert values to the InsertItemTemplate template by setting the KeepInInsertMode property to true.

For more information about how to handle events, see NIB: Consuming Events.

The following example shows how to add an event handler for the ItemInserted event.

System_CAPS_security Security Note

This example has a text box that accepts user input, which is a potential security threat. By default, ASP.NET Web pages validate that user input does not include script or HTML elements. For more information, see Script Exploits Overview.

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

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