UpdatePanel.ContentTemplate Property

Reference

Definition

Namespace:: System.Web.UI

Assembly:: System.Web.Extensions.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

ITemplate

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

Attributes: BrowsableAttribute PersistenceModeAttribute TemplateInstanceAttribute

Exceptions

InvalidOperationException

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

Dela via