EditorZone.ZoneTemplate Properti

Definisi

Ruang nama:

System.Web.UI.WebControls.WebParts

Rakitan:

System.Web.dll

Menyediakan templat untuk memuat kontrol anak dalam EditorZone kontrol dalam format persistensi halaman.

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

Nilai Properti

ITemplate

ITemplate Templat zona yang bertindak sebagai kontainer untuk kontrol anak di zona tersebut.

Atribut

BrowsableAttribute PersistenceModeAttribute TemplateContainerAttribute TemplateInstanceAttribute

Contoh

Contoh kode berikut menunjukkan penggunaan ZoneTemplate properti secara deklaratif. Kode lengkap untuk contoh ditemukan di bagian Contoh dari EditorZone gambaran umum kelas.

Contoh kode menunjukkan bagaimana EditorPart kontrol dapat ditempatkan dalam <zonetemplate> elemen dalam EditorZone kontrol.

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

Saat memuat halaman di browser, Anda dapat memilih Edit Mode di daftar drop-down untuk beralih ke mode edit. Untuk menampilkan antarmuka pengguna pengeditan (UI), Anda dapat mengklik menu kata kerja (panah ke bawah) di bilah judul salah satu dari dua kontrol, dan klik Edit untuk mengedit kontrol. Dengan antarmuka pengguna pengeditan terlihat, Anda dapat melihat beberapa EditorPart kontrol yang dideklarasikan dalam <zonetemplate> elemen .

Keterangan

Properti ZoneTemplate adalah perbedaan utama antara EditorZone kelas dan kelas dasar EditorZoneBase . Dengan menambahkan dukungan untuk templat zona, EditorZone kelas memungkinkan pengembang halaman menempatkan kontrol anak EditorPart dalam EditorZone kontrol dalam markup deklaratif halaman Web. Templat zona bertindak sebagai kontainer untuk kontrol anak.

Catatan

Pengakses set untuk ZoneTemplate properti memanggil InvalidateEditorParts metode , yang memaksa pengumpulan EditorPart kontrol yang dideklarasikan dalam templat untuk dibuat ulang. Ini menyebabkan perubahan apa pun dalam konten templat dikenali.

Untuk menggunakan templat zona secara deklaratif dalam EditorZone kontrol, Anda menambahkan sepasang <zonetemplate> tag, dan kontrol referensi EditorPart di antara tag. Hanya satu templat zona yang dirender per instans EditorZone kontrol (oleh karena itu, tidak ada alasan untuk menambahkan beberapa <zonetemplate> elemen ke EditorZone kontrol). Selain itu, templat EditorZone zona kontrol hanya dapat berisi kontrol bagian yang berasal dari EditorPart kelas.

Lihat juga

• ZoneTemplate
• ITemplate
• InvalidateEditorParts()
• ASP.NET Kontrol Komponen Web