ListView::InsertNewItem Method
Inserts the current record in the data source.
Assembly: System.Web.Extensions (in System.Web.Extensions.dll)
Parameters
- causesValidation
- Type: System::Boolean
true to perform page validation when this method is called; otherwise, false.
| Exception | Condition |
|---|---|
| InvalidOperationException | The ListView control does not have an insert item. -or- The DataSourceView object associated with the ListView control is nullptr. |
Use the InsertNewItem method to programmatically insert an item in the data source. This method is typically used to insert an item from outside the ListView control, such as from a different control on the page.
To use the InsertNewItem method, you must define an InsertItemTemplate template in the ListView control. You must also set the InsertItemPosition property to a value different from InsertItemPosition::None. To specify whether page validation is performed before the insert operation, use the causesValidation parameter.
This method raises the ItemInserted and ItemInserting events.
The following example shows how to use the InsertNewItem method to programmatically insert the contents of the insert item of a ListView control into the data source.
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. |
Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003
The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Security Note: