共用方式為

WebPartZone.ZoneTemplate 屬性

  • 參考

定義

命名空間:
System.Web.UI.WebControls.WebParts
組件:
System.Web.dll

取得或設定 ITemplate 執行個體的參考，該執行個體包含 Web 網頁標記中宣告的控制項。

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 控制項的註冊。

範例

下列程式代碼範例示範在 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> 宣告控件，則會擲回例外狀況。

適用於

另請參閱