Поделиться через

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 Регистрация элементов управления в зоне уже завершена.

Примеры

В следующем примере кода показано использование 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.

При добавлении статических или других элементов управления WebPartZone сервера в декларативную WebPart разметку веб-страницы необходимо поместить теги для элементов управления в пару тегов<zonetemplate>. Если вы не объявляете элементы управления в <zonetemplate> тегах, создается исключение.

Применяется к

См. также раздел