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