UpdatePanel.ContentTemplate Property

Definition

Gets or sets the template that defines the content of the UpdatePanel control.

public:
 property System::Web::UI::ITemplate ^ ContentTemplate { System::Web::UI::ITemplate ^ get(); void set(System::Web::UI::ITemplate ^ value); };
[System.ComponentModel.Browsable(false)]
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
[System.Web.UI.TemplateInstance(System.Web.UI.TemplateInstance.Single)]
public System.Web.UI.ITemplate ContentTemplate { get; set; }
[<System.ComponentModel.Browsable(false)>]
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
[<System.Web.UI.TemplateInstance(System.Web.UI.TemplateInstance.Single)>]
member this.ContentTemplate : System.Web.UI.ITemplate with get, set
Public Property ContentTemplate As ITemplate

Property Value

An ITemplate instance that defines the content of the UpdatePanel control. The default is null.

Attributes

Exceptions

The ContentTemplate property of the UpdatePanel control is set after an instance of the template is created or after the content template container is created.

Remarks

The ContentTemplate property contains the content that appears inside an UpdatePanel control when it is rendered. You can create the template's content declaratively or programmatically. The content template of an UpdatePanel control is a single-instance template. Therefore, the properties of the controls it contains can be accessed directly on the page without using the FindControl method. For more information, see the TemplateInstanceAttribute class overview.

To add items to the UpdatePanel control declaratively, add an <ContentTemplate> element between the opening and closing tags of the UpdatePanel control. Inside the <ContentTemplate> element tags, declare other controls and HTML elements.

To add items to the UpdatePanel control dynamically, use the ContentTemplateContainer property, which enables you to add child controls without having to create a custom template that implements the ITemplate interface.

Applies to

See also