WebPartZoneCollection Konstruktor

Definisi

Ruang nama:

System.Web.UI.WebControls.WebParts

Rakitan:

System.Web.dll

Menginisialisasi instans baru kelas WebPartZoneCollection.

Overload

WebPartZoneCollection()	Menginisialisasi instans WebPartZoneCollection kosong kelas.
WebPartZoneCollection(ICollection)	Menginisialisasi instans WebPartZoneCollection kelas dengan meneruskan kumpulan WebPartZone objek.

Keterangan

WebPartZoneCollection Konstruktor digunakan oleh WebPartManager kontrol, oleh kontrol lain dalam set kontrol Bagian Web, atau dengan kode pengembang kustom, untuk membuat kumpulan WebPartZone kontrol baca-saja yang ada pada halaman Bagian Web.

WebPartZoneCollection()

Menginisialisasi instans WebPartZoneCollection kosong kelas.

public:
 WebPartZoneCollection();

public WebPartZoneCollection ();

Public Sub New ()

Keterangan

Kontrol WebPartManager menggunakan konstruktor ini dalam konstruktornya sendiri untuk menginisialisasi contoh WebPartZoneCollection baru kelas untuk halaman Bagian Web.

Lihat juga

• ASP.NET Kontrol Bagian Web

WebPartZoneCollection(ICollection)

Menginisialisasi instans WebPartZoneCollection kelas dengan meneruskan kumpulan WebPartZone objek.

public:
 WebPartZoneCollection(System::Collections::ICollection ^ webPartZones);

public WebPartZoneCollection (System.Collections.ICollection webPartZones);

new System.Web.UI.WebControls.WebParts.WebPartZoneCollection : System.Collections.ICollection -> System.Web.UI.WebControls.WebParts.WebPartZoneCollection

Public Sub New (webPartZones As ICollection)

Parameter

webPartZones

ICollection

Sebuah ICollectionWebPartZone objek.

Pengecualian

ArgumentNullException

Pengumpulan zona adalah null.

ArgumentException

Salah satu objek dalam koleksi adalah null atau bukan tipe WebPartZone.

Contoh

Contoh kode berikut menunjukkan penggunaan WebPartZoneCollection konstruktor. Kode lengkap untuk contoh ditemukan di bagian Contoh dari WebPartZoneCollection gambaran umum kelas.

Di bagian kode berikut, perhatikan bahwa ia menetapkan WebPartZoneCollection objek ke variabel dengan mengambil nilai Zones properti . Jika Anda mau, daripada menetapkan semua zona dari Zones properti , Anda dapat membuat array WebPartZoneBase objek yang berisi subset semua zona di halaman, dan menetapkan array ke objek baru WebPartZoneCollection .

protected void Button5_Click(object sender, EventArgs e)
{
  Label1.Text = String.Empty;

  WebPartZoneCollection zoneCollection = mgr.Zones;
  foreach (WebPartZone zone in zoneCollection)
  {

    if (zone.WebPartVerbRenderMode == WebPartVerbRenderMode.Menu)
      zone.WebPartVerbRenderMode = WebPartVerbRenderMode.TitleBar;
    else
      zone.WebPartVerbRenderMode = WebPartVerbRenderMode.Menu;
  }
}

Protected Sub Button5_Click(ByVal sender As Object, ByVal e As EventArgs)
  Label1.Text = String.Empty

  Dim zoneCollection As WebPartZoneCollection = mgr.Zones
  Dim zone As WebPartZone
  For Each zone In zoneCollection
    If zone.WebPartVerbRenderMode = WebPartVerbRenderMode.Menu Then
      zone.WebPartVerbRenderMode = WebPartVerbRenderMode.TitleBar
    Else
      zone.WebPartVerbRenderMode = WebPartVerbRenderMode.Menu
    End If
  Next zone

End Sub

Setelah koleksi dibuat, Anda dapat dengan mudah melakukan iterasi melalui koleksi dan melakukan operasi pada semua zona yang terkandung atau kontennya. Untuk menjalankan kode contoh, muat halaman di browser, dan klik tombol Alihkan Mode Render Kata Kerja di setiap zona. Ini bergantian bagaimana kata kerja di bilah judul setiap kontrol server yang terkandung dalam zona dirender. Kata kerja dapat muncul di menu drop-down, atau langsung sebagai tautan di bilah judul.

Keterangan

WebPartZoneCollection Gunakan konstruktor saat Anda ingin membuat koleksi WebPartZone objek kustom untuk melakukan operasi terprogram pada objek tersebut. Misalnya, Anda dapat mengakses Zones properti dan membuat subset WebPartZone objek pada halaman Bagian Web, menetapkannya ke WebPartZoneCollection objek, lalu melakukan operasi pada kontrol anak atau berbagai properti hanya dari subset zona tersebut.

Lihat juga

• ASP.NET Kontrol Bagian Web