EditorZone.ZoneTemplate Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls.WebParts
Zestaw:
System.Web.dll

Udostępnia szablon zawierający kontrolki podrzędne w kontrolce EditorZone w formacie trwałości strony.

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

Wartość właściwości

ITemplate

Szablon ITemplate strefy, który działa jako kontener kontrolek podrzędnych w strefie.

Atrybuty
BrowsableAttribute PersistenceModeAttribute TemplateContainerAttribute TemplateInstanceAttribute

Przykłady

Poniższy przykład kodu pokazuje deklaratywne użycie ZoneTemplate właściwości. Pełny kod przykładu znajduje się w sekcji EditorZone Przykład przeglądu klasy.

W przykładzie kodu pokazano, jak EditorPart kontrolki można umieścić w <zonetemplate> elemecie w kontrolce 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>

Po załadowaniu strony w przeglądarce możesz wybrać pozycję Tryb edycji na liście rozwijanej, aby przełączyć się do trybu edycji. Aby wyświetlić interfejs użytkownika edycji, możesz kliknąć menu czasowników (strzałkę w dół) na pasku tytułu jednego z dwóch kontrolek, a następnie kliknąć przycisk Edytuj , aby edytować kontrolkę. Dzięki widocznej edycji interfejsu użytkownika można zobaczyć kilka EditorPart kontrolek zadeklarowanych w elemecie <zonetemplate> .

Uwagi

Właściwość ZoneTemplate jest kluczową różnicą między klasą EditorZone a klasą bazową EditorZoneBase . Dodając obsługę szablonu strefy, EditorZone klasa umożliwia deweloperom stron umieszczanie kontrolek podrzędnych EditorPart w kontrolce EditorZone w deklaratywnej adiustacji strony sieci Web. Szablon strefy działa jako kontener kontrolek podrzędnych.

Uwaga

Metoda dostępu zestawu dla ZoneTemplate właściwości wywołuje metodę InvalidateEditorParts , która wymusza ponowne utworzenie kolekcji EditorPart kontrolek zadeklarowanych w szablonie. Powoduje to rozpoznanie wszelkich zmian w zawartości szablonu.

Aby deklaratywnie używać szablonu strefy w kontrolce EditorZone , należy dodać parę tagów i kontrolki <zonetemplate> odwołania EditorPart między tagami. Tylko jeden szablon strefy jest renderowany na wystąpienie kontrolki EditorZone (dlatego nie ma powodu, aby dodać wiele <zonetemplate> elementów do kontrolki EditorZone ). Ponadto szablon strefy kontrolki EditorZone może zawierać tylko kontrolki części pochodzące z EditorPart klasy.

Dotyczy

Zobacz też