EditorZoneBase.EditorParts 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 koleksi semua kontrol yang EditorPart terkandung dalam EditorZoneBase zona.

public:
 property System::Web::UI::WebControls::WebParts::EditorPartCollection ^ EditorParts { System::Web::UI::WebControls::WebParts::EditorPartCollection ^ get(); };

[System.ComponentModel.Browsable(false)]
public System.Web.UI.WebControls.WebParts.EditorPartCollection EditorParts { get; }

[<System.ComponentModel.Browsable(false)>]
member this.EditorParts : System.Web.UI.WebControls.WebParts.EditorPartCollection

Public ReadOnly Property EditorParts As EditorPartCollection

Nilai Properti

EditorPartCollection

Yang EditorPartCollection berisi semua kontrol individu EditorPart dalam zona.

Atribut: BrowsableAttribute

Pengecualian

InvalidOperationException

Yang EditorPart ditambahkan ke koleksi tidak memiliki nilai yang ditetapkan ke properti ID-nya.

Contoh

Contoh kode berikut menunjukkan cara mengakses EditorParts properti secara terprogram. Untuk kode lengkap yang diperlukan untuk menjalankan contoh, lihat bagian EditorZoneBase Contoh topik gambaran umum kelas.

Bagian pertama dari contoh kode menunjukkan bahwa EditorParts properti berisi referensi ke semua EditorPart kontrol yang direferensikan secara deklaratif di halaman Web.

<aspSample:MyEditorZone ID="EditorZone1" runat="server">
  <ApplyVerb Text="Apply Changes" />
  <CancelVerb Text="Cancel Changes" />
  <OKVerb Text="Finished" />
  <ZoneTemplate>
    <asp:AppearanceEditorPart ID="AppearanceEditorPart1" 
      runat="server" />
    <asp:LayoutEditorPart ID="LayoutEditorPart1" 
      runat="server" />
  </ZoneTemplate>
</aspSample:MyEditorZone>

<aspSample:MyEditorZone ID="EditorZone1" runat="server">
  <ApplyVerb Text="Apply Changes" />
  <CancelVerb Text="Cancel Changes" />
  <OKVerb Text="Finished" />
  <ZoneTemplate>
    <asp:AppearanceEditorPart ID="AppearanceEditorPart1" 
      runat="server" />
    <asp:LayoutEditorPart ID="LayoutEditorPart1" 
      runat="server" />
  </ZoneTemplate>
</aspSample:MyEditorZone>

Bagian kedua dari contoh kode secara terprogram mengakses EditorParts properti dan mencantumkan ID setiap kontrol dalam Label kontrol.

void Button3_Click(object sender, EventArgs e)
{
  Label1.Text = "<br />";
  foreach (EditorPart part in EditorZone1.EditorParts)
  {
    Label1.Text += part.ID + "<br />";
  }
}

Sub Button3_Click(ByVal sender As Object, ByVal e As EventArgs)
  Label1.Text = "<br />"
  Dim part As EditorPart
  For Each part In EditorZone1.EditorParts
    Label1.Text += part.ID + "<br />"
  Next part
End Sub

Saat memuat halaman di browser, Anda dapat mengklik tombol Tampilkan Koleksi EditorParts untuk mencantumkan ID semua kontrol yang EditorPart dirujuk dalam EditorParts properti .

Keterangan

Properti EditorParts menyediakan referensi ke kumpulan semua EditorPart kontrol di zona tersebut. Ini mereferensikan EditorPart kontrol yang disediakan dengan set kontrol Bagian Web, dan kontrol kustom EditorPart apa pun yang ditambahkan ke zona tersebut. Karena koleksi bersifat baca-saja, pengembang yang ingin membuat kontrol kustom EditorPart untuk tujuan pengeditan umum dan menambahkannya ke koleksi harus mengambil CreateEditorParts alih metode .

Jika Anda merancang kontrol kustom EditorPart untuk mengedit kontrol tertentu WebPart , Anda harus mengambil alih anggota IWebEditable antarmuka -- CreateEditorParts metode dan WebBrowsableObject properti --dalam WebPart kontrol. Alasan untuk mengambil alih anggota ini adalah untuk mengaktifkan kontrol Anda WebPart untuk membuat kontrol kustom EditorPart dan menambahkannya ke EditorParts koleksi ketika kontrol Anda sedang diedit, dan untuk memberikan kontrol pengeditan dengan referensi objek ke WebPart kontrol yang mereka edit. Jika Anda ingin menambahkan kontrol kustom EditorPart untuk mengedit kontrol server yang tidak mewarisi dari WebPart kelas , Anda harus mengimplementasikan IWebEditable antarmuka di kelas seperti yang WebPart Anda lakukan untuk kontrol.

Catatan

Perhatikan bahwa setiap EditorPart yang ditambahkan ke kumpulan EditorPart kontrol dalam implementasi CreateEditorParts metode harus memiliki nilai yang ditetapkan ke properti ID-nya, jika tidak, pengecualian akan dilemparkan ketika koleksi ditetapkan ke EditorParts properti .

Berlaku untuk

Bagikan melalui