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

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 элементе управления в декларативной разметке веб-страницы. Шаблон зоны выступает в качестве контейнера для дочерних элементов управления.

Замечание

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

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

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

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