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> 宣告控制項，則會擲回例外狀況。

適用於

另請參閱