EditorZone.ZoneTemplate Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Fornisce un modello che contiene controlli figlio all'interno di un controllo EditorZone in un formato di persistenza della pagina.

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

Valore della proprietà

ITemplate

Un modello di zona ITemplate che funge da contenitore per controlli figlio presenti nella zona.

Attributi
BrowsableAttribute PersistenceModeAttribute TemplateContainerAttribute TemplateInstanceAttribute

Esempio

Nell'esempio di codice seguente viene illustrato l'uso dichiarativo della ZoneTemplate proprietà. Il codice completo per l'esempio è disponibile nella sezione Esempio della panoramica della EditorZone classe.

Nell'esempio di codice viene illustrato come EditorPart i controlli possono essere inseriti all'interno di un elemento in un <zonetemplate> EditorZone controllo.

<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>

Quando si carica la pagina in un browser, è possibile selezionare Modalità di modifica nell'elenco a discesa per passare alla modalità di modifica. Per visualizzare l'interfaccia utente di modifica , è possibile fare clic sul menu verbi (freccia verso il basso) nella barra del titolo di uno dei due controlli e fare clic su Modifica per modificare il controllo. Con l'interfaccia utente di modifica visibile, è possibile visualizzare i diversi EditorPart controlli dichiarati all'interno dell'elemento <zonetemplate> .

Commenti

La ZoneTemplate proprietà è la differenza chiave tra la classe e la EditorZone classe di base EditorZoneBase . Aggiungendo il supporto per un modello di zona, la EditorZone classe consente agli sviluppatori di pagine di inserire controlli figlio EditorPart all'interno di un EditorZone controllo nel markup dichiarativo di una pagina Web. Il modello di zona funge da contenitore per i controlli figlio.

Nota

La funzione di accesso set per la ZoneTemplate proprietà chiama il InvalidateEditorParts metodo, che forza la raccolta di EditorPart controlli dichiarati nel modello per essere ricreata. In questo modo, le modifiche apportate al contenuto del modello devono essere riconosciute.

Per usare un modello di zona dichiarativamente all'interno di un EditorZone controllo, aggiungere una coppia di tag e controlli di <zonetemplate> riferimento EditorPart tra i tag. Viene eseguito il rendering di un solo modello di zona per ogni istanza di un EditorZone controllo, pertanto non esiste alcun motivo per aggiungere più <zonetemplate> elementi a un EditorZone controllo. Inoltre, il modello di zona di un EditorZone controllo può contenere solo controlli di parte che derivano dalla EditorPart classe.

Si applica a

Vedi anche