WebPartZone.ZoneTemplate Właściwość

  • Odwołanie

Definicja

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

Pobiera lub ustawia odwołanie do ITemplate wystąpienia zawierającego kontrolki zadeklarowane w znacznikach strony sieci Web.

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

Element ITemplate zawierający kontrolki WebPart w strefie.

Atrybuty
BrowsableAttribute PersistenceModeAttribute TemplateInstanceAttribute

Wyjątki

InvalidOperationException

WebPart Rejestracja kontrolek w strefie jest już zakończona.

Przykłady

W poniższym przykładzie kodu pokazano użycie ZoneTemplate właściwości w deklaratywnej adiustacji strony składników Web Part. Pełny kod przykładu, w tym klasa niestandardowa i strona aspx do hostowania kontrolki, znajduje się w sekcji Przykład tematu WebPartZone przeglądu klasy.

Zwróć uwagę, że w znacznikach dla kontrolki WebPartZone znajduje <zonetemplate> się element zawierający odwołanie do kontrolki Kalendarz. Jeśli chcesz dodać dodatkowe WebPart kontrolki lub inne kontrolki serwera do strefy, możesz również dodać je w tagach <zonetemplate> .

<cc1:MyWebPartZone ID="MyWebPartZone1" runat="server">
  <VerbStyle Font-Italic="true" />
  <PartChromeStyle BackColor="lightblue" />
  <PartStyle BackColor="gray" />
  <PartTitleStyle Font-Bold="true" />
  <ZoneTemplate>
    <asp:Calendar ID="Calendar1" runat="server" 
      Title="My Calendar" />
  </ZoneTemplate>
</cc1:MyWebPartZone>

<cc1:MyWebPartZone ID="MyWebPartZone1" runat="server">
  <VerbStyle Font-Italic="true" />
  <PartChromeStyle BackColor="lightblue" />
  <PartStyle BackColor="gray" />
  <PartTitleStyle Font-Bold="true" />
  <ZoneTemplate>
    <asp:Calendar ID="Calendar1" runat="server" 
      Title="My Calendar" />
  </ZoneTemplate>
</cc1:MyWebPartZone>

Uwagi

Właściwość ZoneTemplate odwołuje się do ITemplate wystąpienia w kontrolce WebPartZone . Szablon zawiera kontrolki serwera statycznego, które można zadeklarować w kontrolce WebPartZone , w tym WebPart kontrolki, kontrolki użytkownika, kontrolki niestandardowe i kontrolki ASP.NET.

Po dodaniu statycznych WebPart lub innych kontrolek serwera do WebPartZone elementu w deklaratywnej adiustacji strony sieci Web należy umieścić tagi dla kontrolek w ramach pary tagów <zonetemplate> . Jeśli nie deklarujesz kontrolek w tagach <zonetemplate> , zostanie zgłoszony wyjątek.

Dotyczy

Zobacz też