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 přehledu EditorZone třídy.

Příklad kódu ukazuje, jak EditorPart lze ovládací prvky umístit do <zonetemplate> prvku v ovládacím EditorZone prvku.

<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 ze dvou ovládacích prvků a kliknutím na Upravit ovládací prvek upravit. Když je uživatelské rozhraní pro úpravy viditelné, můžete zobrazit několik EditorPart ovládacích prvků, které jsou deklarovány v rámci elementu <zonetemplate> .

Poznámky

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

Poznámka:

Objekt set pro ZoneTemplate vlastnost volá metodu InvalidateEditorParts , která vynutí opětovné vytvoření kolekce ovládacích EditorPart prvků deklarovaných v šabloně. To způsobí, že se rozpoznanou 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 instanci EditorZone ovládacího prvku se vykreslí pouze jedna šablona zóny (proto není důvod k přidání více <zonetemplate> prvků do EditorZone ovládacího prvku). Šablona zóny EditorZone ovládacího prvku může obsahovat pouze ovládací prvky části odvozené z EditorPart třídy.

Platí pro

Viz také