Export (0) Print
Expand All
Expand Minimize

FormView::ItemTemplate Property

Gets or sets the custom content for the data row in a FormView control when the control is in read-only mode.

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

[BrowsableAttribute(false)]
[PersistenceModeAttribute(PersistenceMode::InnerProperty)]
[TemplateContainerAttribute(typeof(FormView), BindingDirection::TwoWay)]
public:
virtual property ITemplate^ ItemTemplate {
	ITemplate^ get ();
	void set (ITemplate^ value);
}
<asp:FormView>
	<ItemTemplate>ITemplate</ItemTemplate>
</asp:FormView>

Property Value

Type: System.Web.UI::ITemplate
A System.Web.UI::ITemplate that contains the custom content for the data row when the FormView control is in read-only 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

EditItemTemplate

Insert

InsertItemTemplate

Read-only

ItemTemplate

Use the ItemTemplate property to define your own user interface (UI) for the data row when the FormView control is in read-only mode. The item template usually contains controls to display the field values of a record, as well as command buttons to edit, insert, and delete a record.

To specify the custom template, first place <ItemTemplate> 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 <ItemTemplate> tags. To display the field values of the data source bound to the control, use a data-binding expression. For more information on data-binding expressions, see Data-Binding Expression Syntax. To create command buttons that perform the built-in delete, edit, and new record 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

Delete

"Delete"

Edit

"Edit"

New

"New"

You can control the appearance of the item template by using the RowStyle property.

The following example demonstrates how to define a custom template for a data row in read-only mode.

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

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft