EditorZone.ZoneTemplate Vlastnost

Definice

Obor názvů:

System.Web.UI.WebControls.WebParts

Sestavení:

System.Web.dll

Poskytuje šablonu, která obsahuje podřízené ovládací prvky v ovládacím EditorZone prvku ve formátu trvalosti stránky.

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

Hodnota vlastnosti

ITemplate

Šablona ITemplate zóny, která funguje jako kontejner pro podřízené ovládací prvky v zóně.

Atributy

BrowsableAttribute PersistenceModeAttribute TemplateContainerAttribute TemplateInstanceAttribute

Příklady

Následující příklad kódu ukazuje deklarativní použití ZoneTemplate vlastnosti. Úplný kód příkladu najdete v části Příklad v přehledu EditorZone třídy.

Příklad kódu ukazuje, jak EditorPart lze ovládací prvky umístit do elementu <zonetemplate> v ovládacím prvku 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>

Když stránku načtete v prohlížeči, můžete v rozevíracím seznamu vybrat Režim úprav a přepnout do režimu úprav. Pokud chcete zobrazit uživatelské rozhraní pro úpravy, můžete kliknout na nabídku sloves (šipka dolů) v záhlaví jednoho z těchto dvou ovládacích prvků a kliknout na Upravit a ovládací prvek upravit. Když je uživatelské rozhraní pro úpravy viditelné, můžete vidět několik EditorPart ovládacích prvků, které jsou deklarovány v elementu <zonetemplate> .

Poznámky

Vlastnost ZoneTemplate je klíčovým rozdílem EditorZone mezi třídou a základní EditorZoneBase třídou. Přidáním podpory pro šablonu EditorZone zóny třída umožňuje vývojářům stránek umístit podřízené EditorPart ovládací prvky v ovládacím EditorZone prvku do deklarativních značek webové stránky. Šablona zóny funguje jako kontejner pro podřízené ovládací prvky.

Poznámka

Objekt set pro vlastnost ZoneTemplate volá metodu InvalidateEditorParts , která vynutí opětovné vytvoření kolekce ovládacích EditorPart prvků deklarovaných v šabloně. To způsobí, že budou rozpoznány všechny změny v obsahu šablony.

Pokud chcete šablonu zóny použít deklarativně v rámci EditorZone ovládacího prvku, přidáte mezi značky <zonetemplate> dvojici značek a referenční EditorPart ovládací prvky. Na každou instanci EditorZone ovládacího prvku se vykresluje pouze jedna šablona zóny (proto není důvod přidávat do EditorZone ovládacího prvku více <zonetemplate> prvků). Také šablona zóny ovládacího prvku EditorZone může obsahovat pouze část ovládací prvky, které jsou odvozeny EditorPart z třídy.

Viz také

• ZoneTemplate
• ITemplate
• InvalidateEditorParts()
• ASP.NET ovládací prvky webových částí