WebPartZone.ZoneTemplate Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает ссылку на экземпляр 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, содержащий элементы управления WebPart в зоне.
- Атрибуты
Исключения
Регистрация элементов управления 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>
тегах, создается исключение.