Adding records with InsertItemTemplate

Use the InsertItemTemplate property to define a custom user interface (UI) for the insert item in the ListView control. This UI is rendered either at the start or at the end of the displayed items. You specify where the UI is rendered by using the InsertItemPosition property.

The InsertItemTemplate template usually contains the input controls for the user to enter the values for a new record. It also usually contains buttons or hyperlinks to insert the record and to cancel the insert operation.

To specify the custom template declaratively, add an InsertItemTemplate element inside the ListView element. You can then add the contents of the template to the InsertItemTemplate element. You can associate a field with an input control by using a two-way binding expression. When a record is inserted, the ListView control automatically extracts the field value from the associated input control.

To create buttons that perform the built-in cancel and insert operations, add a button control to the template. Set its CommandName property to one of the values listed in the following table.

You can control the position of the insert item in the ListView control by using the InsertItemPosition property.

The following example shows how to define a custom template for the insert item of a ListView control. This code example is part of a larger example provided for the ItemInserted event.

  DataSourceID="ContactsDataSource"
  DataKeyNames="ContactID"
  OnItemInserted="ContactsListView_ItemInserted"  
  InsertItemPosition="LastItem"
  runat="server">