WebPartZone.ZoneTemplate Properti

Referensi

Definisi

Ruang nama:: System.Web.UI.WebControls.WebParts

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mendapatkan atau mengatur referensi ke ITemplate instans yang berisi kontrol yang dideklarasikan dalam markup halaman 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

Nilai Properti

ITemplate

Yang ITemplate berisi WebPart kontrol dalam zona.

Atribut: BrowsableAttribute PersistenceModeAttribute TemplateInstanceAttribute

Pengecualian

InvalidOperationException

WebPart Pendaftaran kontrol di zona sudah selesai.

Contoh

Contoh kode berikut menunjukkan penggunaan ZoneTemplate properti dalam markup deklaratif halaman Bagian Web. Kode lengkap untuk contoh, termasuk kelas kustom dan halaman .aspx untuk menghosting kontrol, ditemukan di bagian WebPartZone Contoh topik gambaran umum kelas.

Perhatikan bahwa, dalam markup untuk WebPartZone kontrol, ada <zonetemplate> elemen yang berisi referensi ke kontrol Kalender. Jika Anda ingin menambahkan kontrol tambahan WebPart atau kontrol server lain ke zona tersebut, Anda juga dapat menambahkannya dalam <zonetemplate> tag.

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

Keterangan

Properti ZoneTemplate mengacu pada instans ITemplate dalam WebPartZone kontrol. Templat berisi kontrol server statis yang dapat Anda deklarasikan dalam WebPartZone kontrol, termasuk WebPart kontrol, kontrol pengguna, kontrol kustom, dan kontrol ASP.NET.

Saat Anda menambahkan kontrol statis WebPart atau server lain ke WebPartZone dalam markup deklaratif halaman Web, Anda harus menempatkan tag untuk kontrol dalam sepasang <zonetemplate> tag. Jika Anda tidak mendeklarasikan kontrol dalam <zonetemplate> tag, pengecualian akan dilemparkan.

Berlaku untuk

Bagikan melalui