WebPartManager.CopyWebPart(WebPart) Metode

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.

Digunakan oleh kontrol Bagian Web yang diatur untuk membuat salinan WebPart kontrol server atau untuk tujuan menambahkan kontrol ke halaman Web.

protected:
 virtual System::Web::UI::WebControls::WebParts::WebPart ^ CopyWebPart(System::Web::UI::WebControls::WebParts::WebPart ^ webPart);

protected virtual System.Web.UI.WebControls.WebParts.WebPart CopyWebPart (System.Web.UI.WebControls.WebParts.WebPart webPart);

abstract member CopyWebPart : System.Web.UI.WebControls.WebParts.WebPart -> System.Web.UI.WebControls.WebParts.WebPart
override this.CopyWebPart : System.Web.UI.WebControls.WebParts.WebPart -> System.Web.UI.WebControls.WebParts.WebPart

Protected Overridable Function CopyWebPart (webPart As WebPart) As WebPart

Parameter

webPart: WebPart

WebPart Kontrol server atau yang akan disalin.

Mengembalikan

WebPart

yang WebPart akan ditambahkan ke halaman.

Keterangan

Anda tidak dapat memanggil metode langsung CopyWebPart dari kode Anda. Metode ini dipanggil secara internal oleh WebPartManager kontrol sebagai bagian dari proses penambahan kontrol dinamis WebPart atau server baru ke halaman. Kontrol dinamis ditambahkan ke halaman secara terprogram atau melalui antarmuka pengguna (UI) Bagian Web, misalnya oleh pengguna yang menambahkan kontrol dari katalog kontrol, dibandingkan dengan kontrol statis, yang dideklarasikan langsung dalam markup halaman.

Catatan

Metode ini dapat ditimpa di kelas turunan jika pengembang ingin mengaktifkan metode untuk menangani skenario penyalinan kontrol tambahan. Untuk detailnya, lihat bagian Catatan untuk Pewaris.

Ketika kontrol dinamis baru ditambahkan, jika itu adalah WebPart kontrol, CopyWebPart metode mengembalikan instans kontrol baru. Jika kontrol yang ditambahkan adalah beberapa tipe kontrol server lain (seperti kontrol pengguna, kontrol kustom, atau kontrol ASP.NET), kontrol akan sudah dibungkus dengan objek oleh GenericWebPart set kontrol Bagian Web. CopyWebPart Ketika metode menemukan GenericWebPart kontrol, metode mengembalikan instans GenericWebPart kontrol baru dengan instans baru kontrol anak yang dibungkus di dalamnya.

CopyWebPart Saat metode membuat salinan baru kontrol untuk dikembalikan, metode ini juga mengatur ulang nilai semua properti ke nilai defaultnya. Perhatikan bahwa, jika Anda ingin mempertahankan nilai properti yang dapat dipersonalisasi dan menyalinnya ke instans kontrol baru, Anda juga harus memanggil CopyPersonalizationState metode . Langkah terakhir yang CopyWebPart dilakukan oleh metode ini adalah memanggil CreateDynamicWebPartID metode untuk mendapatkan ID baru untuk kontrol.

Catatan

Karena metode memperoleh ID baru untuk kontrol yang disalin, Anda tidak boleh mengandalkan referensi kontrol dinamis yang ditambahkan ke halaman dengan ID aslinya. Sebagai gantinya, Anda harus mereferensikan instans baru kontrol yang dikembalikan oleh metode .

Catatan Bagi Inheritor

Metode ini dinyatakan sebagai virtual sehingga pengembang dapat mewarisi dari WebPartManager kelas, mengambil alih metode , dan menyediakan skenario tambahan di mana ia dapat membuat salinan kontrol. Misalnya, metode dapat secara opsional menerima sebagai input kontrol yang telah diserialisasikan ke dalam file XML. Metode ini dapat mendeserialisasi XML (jika ada), lalu memanggil metode dasar untuk menangani kasus yang ada dan mengembalikan instans WebPart kontrol baru.

Berlaku untuk

Bagikan melalui