通过

WebPartZone.ZoneTemplate 属性

  • 参考

定义

命名空间:
System.Web.UI.WebControls.WebParts
程序集:
System.Web.dll

获取或设置对 ITemplate 实例的引用，该实例包含网页标记中声明的控件。

public:
 virtual property System::Web::UI::ITemplate ^ ZoneTemplate { 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 virtual System.Web.UI.ITemplate ZoneTemplate { 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.ZoneTemplate : System.Web.UI.ITemplate with get, set
Public Overridable Property ZoneTemplate As ITemplate

属性值

ITemplate

包含区域中 ITemplate 控件的 WebPart。

属性
BrowsableAttribute PersistenceModeAttribute TemplateInstanceAttribute

例外

InvalidOperationException

区域中 WebPart 控件的注册工作已完成。

示例

下面的代码示例演示如何在 Web 部件页的 ZoneTemplate 声明性标记中使用 属性。 该示例的完整代码（包括用于承载控件的自定义类和.aspx页）位于类概述主题的 WebPartZone “示例”部分。

请注意，在 控件的 WebPartZone 标记中，有一个 <zonetemplate> 元素包含对 Calendar 控件的引用。 如果要向区域添加其他 WebPart 控件或其他服务器控件，还可以在标记中添加 <zonetemplate> 它们。

<cc1:MyWebPartZone ID="MyWebPartZone1" runat="server">
  <VerbStyle Font-Italic="true" />
  <PartChromeStyle BackColor="lightblue" />
  <PartStyle BackColor="gray" />
  <PartTitleStyle Font-Bold="true" />
  <ZoneTemplate>
    <asp:Calendar ID="Calendar1" runat="server" 
      Title="My Calendar" />
  </ZoneTemplate>
</cc1:MyWebPartZone>

<cc1:MyWebPartZone ID="MyWebPartZone1" runat="server">
  <VerbStyle Font-Italic="true" />
  <PartChromeStyle BackColor="lightblue" />
  <PartStyle BackColor="gray" />
  <PartTitleStyle Font-Bold="true" />
  <ZoneTemplate>
    <asp:Calendar ID="Calendar1" runat="server" 
      Title="My Calendar" />
  </ZoneTemplate>
</cc1:MyWebPartZone>

注解

属性 ZoneTemplate 引用 ITemplate 控件中的 WebPartZone 实例。 该模板包含可在 控件中 WebPartZone 声明的静态服务器控件，包括 WebPart 控件、用户控件、自定义控件和 ASP.NET 控件。

将静态 WebPart 或其他服务器控件添加到 WebPartZone 网页的声明性标记中的 时，必须将控件的标记放在一对 <zonetemplate> 标记中。 如果未在标记中 <zonetemplate> 声明控件，则会引发异常。

适用于

另请参阅