EditorZone.ZoneTemplate Proprietà

Definizione

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

[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; }

Valore della proprietà

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

Attributi

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 il EditorPart modo in cui 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>

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 dei 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 EditorZone classe e la 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 impone la ricreazione della raccolta di EditorPart controlli dichiarati nel modello. In questo modo tutte le modifiche apportate al contenuto del modello vengono riconosciute.

Per usare un modello di zona in modo dichiarativo all'interno di un EditorZone controllo, aggiungere una coppia di <zonetemplate> tag e controlli di riferimento EditorPart tra i tag. Viene eseguito il rendering di un solo modello di zona per 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

Prodotto Versioni
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Vedi anche