Bagikan melalui

WebPartManager.WebPartsDisconnecting Kejadian

  • Referensi

Definisi

Ruang nama:
System.Web.UI.WebControls.WebParts
Rakitan:
System.Web.dll

Terjadi selama proses mengakhiri koneksi antara kontrol server atau yang sebelumnya tersambung WebPart .

public:
 event System::Web::UI::WebControls::WebParts::WebPartConnectionsCancelEventHandler ^ WebPartsDisconnecting;
public event System.Web.UI.WebControls.WebParts.WebPartConnectionsCancelEventHandler WebPartsDisconnecting;
member this.WebPartsDisconnecting : System.Web.UI.WebControls.WebParts.WebPartConnectionsCancelEventHandler 
Public Custom Event WebPartsDisconnecting As WebPartConnectionsCancelEventHandler

Jenis Acara

WebPartConnectionsCancelEventHandler

Keterangan

Peristiwa WebPartsDisconnecting ini dimunculkan oleh OnWebPartsDisconnecting metode , dan menandakan fakta bahwa pengguna telah mengklik kata kerja pemutusan sambungan, atau DisconnectWebParts metode tersebut telah dipanggil. Acara ini memberikan kesempatan untuk membatalkan proses mengakhiri koneksi sebelum selesai. Jika koneksi berhasil diakhir, peristiwa ini diikuti oleh WebPartsDisconnected peristiwa.

Pengembang halaman dapat menambahkan handler kustom untuk peristiwa tersebut OnWebPartsDisconnecting dengan menambahkan atribut ke <asp:webpartmanager> elemen , dan menetapkan nama metode kustom ke atribut .

Biasanya, ketika WebPartsDisconnecting peristiwa dinaikkan sebagai hasil langsung dari tindakan pengguna yang mengakhiri koneksi, peristiwa dapat dibatalkan. Namun, ada beberapa skenario di mana acara tidak dapat dibatalkan. Skenario pertama adalah, jika kontrol dihapus, WebPart kontrol yang WebPartZone dikandungnya harus ditutup semua, jika tidak, kontrol akan menjadi yatim piatu. Dalam hal WebPartManager ini kontrol menutup WebPart kontrol, bukan pengguna, dan juga harus dapat mengakhiri koneksi kontrol yang terhubung tanpa kemungkinan gangguan, sehingga dapat menyelesaikan proses pembersihan dan penutupan semua kontrol. Oleh karena itu, secara desain WebPartsDisconnecting metode tidak dapat dibatalkan dalam skenario ini. Untuk acara terkait yang dapat dibatalkan, lihat WebPartClosing acara.

Skenario kedua di mana WebPartsDisconnecting peristiwa tidak dapat dibatalkan adalah ketika ActivateConnections metode dipanggil (ini dipanggil selama setiap permintaan ke halaman, misalnya), dan ada beberapa jenis konflik dalam koneksi yang ada di halaman. Misalnya, mungkin pengguna menyambungkan kontrol x untuk mengontrol y, tetapi pengguna bersama menyambungkan kontrol x untuk mengontrol z, namun kontrol x tidak diizinkan untuk membentuk beberapa koneksi. Dalam hal ini, pengaturan pengguna individu untuk koneksi lebih diutamakan, dan WebPartManager kontrol menyelesaikan konflik dengan memanggil DisconnectWebPart metode dan mengakhiri koneksi antara x dan z untuk pengguna tertentu. Karena pemutusan ini sangat penting untuk menyelesaikan konflik, berdasarkan desain WebPartsDisconnecting acara tidak dapat dibatalkan dalam skenario ini.

Skenario ketiga di mana WebPartsDisconnecting metode tidak dapat dibatalkan adalah ketika WebPart kontrol server atau yang saat ini terhubung dihapus atau ditutup. Karena kontrol pasti akan dihapus dari halaman, itu adalah kebutuhan logis untuk menghapus koneksinya. Oleh karena itu, ketika WebPartManager kontrol memanggil DisconnectWebPart metode , yang pada gilirannya WebPartsDisconnecting meningkatkan peristiwa, dengan desain tidak ada kemungkinan membatalkan peristiwa.

Berlaku untuk

Lihat juga