WebPartZone.GetInitialWebParts Metode
Definisi
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.
Mengambil alih metode dasar abstrak dan mendapatkan set awal kontrol statis WebPart yang terkandung dalam templat zona.
protected public:
override System::Web::UI::WebControls::WebParts::WebPartCollection ^ GetInitialWebParts();protected internal override System.Web.UI.WebControls.WebParts.WebPartCollection GetInitialWebParts ();override this.GetInitialWebParts : unit -> System.Web.UI.WebControls.WebParts.WebPartCollectionProtected Friend Overrides Function GetInitialWebParts () As WebPartCollectionMengembalikan
WebPartCollection yang berisi semua WebPart kontrol server atau lainnya yang terkandung dalam templat zona.
Keterangan
Metode ini GetInitialWebParts menyediakan implementasi metode dasar GetInitialWebParts abstrak. Metode dasar tidak menyediakan implementasi, tetapi menyatakan metode sehingga kelas turunan dapat menyesuaikan bagaimana mereka akan mendapatkan serangkaian kontrol awal yang termasuk dalam zona, tanpa memperhitungkan perubahan personalisasi.
Untuk setiap kontrol server yang ditemukan di zona, CreateWebPart metode dipanggil. Jika kontrol mewarisi langsung dari WebPart kelas , kontrol hanya ditambahkan ke koleksi zona WebParts (dan ke koleksi kontrol yang WebPartManager sama). Jika kontrol tidak mewarisi langsung dari WebPart, set kontrol Bagian Web membungkus kontrol dengan GenericWebPart objek, yang memungkinkan kontrol untuk berperilaku sebagai WebPart kontrol pada durasi.
Kelas WebPartZone mengimplementasikan metode dasar dengan mengembalikan kumpulan kontrol (jika ada) yang secara statis dideklarasikan dalam sekumpulan <zonetemplate> tag dalam markup halaman Bagian Web.
PlaceHolder Jika kontrol dideklarasikan dalam zona, kontrol anak dari kontrol tersebut ditambahkan, bukan kontrol itu sendiri. Implementasi ini memungkinkan Anda untuk, misalnya, membuat WebPartZone zona di halaman master, lalu mendeklarasikan kontrol individual WebPart atau server di halaman konten. Jika Anda mendeklarasikan Literal kontrol di zona WebPartZone , kontrol tersebut akan diabaikan.
Catatan
Kumpulan awal kontrol yang dikembalikan oleh GetInitialWebParts metode mungkin berbeda dari kumpulan kontrol run-time aktual di zona, setelah personalisasi terjadi. Misalnya, Anda memiliki halaman Web dengan dua WebPartZone kontrol, dan yang pertama berisi kontrol pengguna bernama User1 yang secara statis dideklarasikan dalam <zonetemplate> tag. Jika pengguna memuat halaman dan menyeret User1 ke zona kedua, maka User1 masih merupakan bagian dari koleksi yang dikembalikan dengan memanggil GetInitialWebParts metode untuk zona pertama, karena dideklarasikan di zona tersebut. Tetapi pada durasi, ketika WebPartManager kontrol memuat data personalisasi, User1 sebenarnya muncul di zona kedua tempat pengguna menyeretnya.
