EditorZone.ZoneTemplate Свойство

Определение

Пространство имен:

System.Web.UI.WebControls.WebParts

Сборка:

System.Web.dll

Предоставляет шаблон, в котором будут содержаться дочерние элементы управления для элемента управления EditorZone в формате сохранения страницы.

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.TemplateContainer(typeof(System.Web.UI.WebControls.WebParts.EditorZone))]
[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.TemplateContainer(typeof(System.Web.UI.WebControls.WebParts.EditorZone))>]
[<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, выступающий в качестве контейнера для дочерних элементов управления в зоне.

Атрибуты

BrowsableAttribute PersistenceModeAttribute TemplateContainerAttribute TemplateInstanceAttribute

Примеры

В следующем примере кода демонстрируется декларативное ZoneTemplate использование свойства . Полный код для примера можно найти в разделе Пример в обзоре EditorZone класса.

В примере кода показано, как EditorPart можно разместить элементы управления в <zonetemplate> элементе EditorZone элемента управления.

<asp:EditorZone ID="EditorZone1" runat="server" >
  <VerbStyle Font-Italic="true" />
  <EditUIStyle BackColor="lightgray" />
  <PartChromeStyle BorderWidth="1" />
  <LabelStyle Font-Bold="true" />
  <CancelVerb Text="Cancel Changes" />
  <ZoneTemplate>
    <asp:AppearanceEditorPart ID="AppearanceEditorPart1" 
      runat="server" />
    <asp:LayoutEditorPart ID="LayoutEditorPart1" 
      runat="server" />
  </ZoneTemplate>
</asp:EditorZone>

<asp:EditorZone ID="EditorZone1" runat="server" >
  <VerbStyle Font-Italic="true" />
  <EditUIStyle BackColor="lightgray" />
  <PartChromeStyle BorderWidth="1" />
  <LabelStyle Font-Bold="true" />
  <CancelVerb Text="Cancel Changes" />
  <ZoneTemplate>
    <asp:AppearanceEditorPart ID="AppearanceEditorPart1" 
      runat="server" />
    <asp:LayoutEditorPart ID="LayoutEditorPart1" 
      runat="server" />
  </ZoneTemplate>
</asp:EditorZone>

При загрузке страницы в браузере можно выбрать Режим редактирования в раскрывающемся списке, чтобы переключиться в режим редактирования. Чтобы отобразить пользовательский интерфейс редактирования, можно щелкнуть меню глаголов (стрелка вниз) в строке заголовка одного из двух элементов управления и нажать кнопку Изменить , чтобы изменить элемент управления. Видимый пользовательский интерфейс редактирования позволяет увидеть несколько EditorPart элементов управления, объявленных в элементе <zonetemplate> .

Комментарии

Свойство ZoneTemplate является ключевым различием между классом EditorZone и базовым EditorZoneBase классом. Добавив поддержку шаблона зоны, EditorZone класс позволяет разработчикам страниц размещать дочерние EditorPart элементы управления в элементе EditorZone управления в декларативной разметке веб-страницы. Шаблон зоны выступает в качестве контейнера для дочерних элементов управления.

Примечание

Метод доступа set для ZoneTemplate свойства вызывает InvalidateEditorParts метод , который приводит к повторному созданию коллекции элементов управления, объявленных EditorPart в шаблоне. Это приводит к распознаванию любых изменений в содержимом шаблона.

Чтобы декларативно использовать шаблон зоны в элементе EditorZone управления, добавьте пару тегов <zonetemplate> и ссылки на EditorPart элементы управления между тегами. Для каждого экземпляра EditorZone элемента управления отображается только один шаблон зоны (поэтому нет причин добавлять в элемент EditorZone управления несколько <zonetemplate> элементов). Кроме того, шаблон EditorZone зоны элемента управления может содержать только элементы управления, производные EditorPart от класса .

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

• ZoneTemplate
• ITemplate
• InvalidateEditorParts()
• элементы управления веб-частей ASP.NET