FormView::InsertItemTemplate Property
Gets or sets the custom content for an item in insert mode.
Assembly: System.Web (in System.Web.dll)
[BrowsableAttribute(false)] [PersistenceModeAttribute(PersistenceMode::InnerProperty)] [TemplateContainerAttribute(typeof(FormView), BindingDirection::TwoWay)] public: virtual property ITemplate^ InsertItemTemplate { ITemplate^ get (); void set (ITemplate^ value); }
<asp:FormView> <InsertItemTemplate>ITemplate</InsertItemTemplate> </asp:FormView>
Property Value
Type: System.Web.UI::ITemplateA System.Web.UI::ITemplate that contains the custom content for the data row when the FormView control is in insert mode. The default value is null, which indicates that this property is not set.
The FormView control renders a different template for the data row based on the current mode of the control (specified by the CurrentMode property). The following table shows which template is used for each mode.
Mode | Template rendered |
|---|---|
Edit | |
Insert | InsertItemTemplate |
Read-only |
Use the InsertItemTemplate property to define your own user interface (UI) for the data row when the FormView control is in insert mode. The insert item template usually contains the input controls for the user to enter the values for the new record, as well as command buttons to insert the record and to cancel the insert operation.
To specify the custom template, first place <InsertItemTemplate> tags between the opening and closing tags of the FormView control. You can then list the contents of the template between the opening and closing <InsertItemTemplate> tags. By using a two-way binding expression, you can associate a field with an input control. When a record is inserted, the FormView control automatically extracts the field value from the associated input control. For more information on two-way binding expressions, see Binding to Databases. To create command buttons that perform the built-in cancel and insert operations, add a command button control to the template with its CommandName property set to one of the values listed in the following table.
Command button type | CommandName value |
|---|---|
Cancel | "Cancel" |
Insert | "Insert" |
You can control the appearance of the item template by using the InsertRowStyle property.
Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
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.