ScriptManager.RegisterDispose(Control, String) Metode

Definisi

Ruang nama:

System.Web.UI

Rakitan:

System.Web.Extensions.dll

dispose Mendaftarkan skrip untuk kontrol yang berada di dalam UpdatePanel kontrol. Skrip dijalankan ketika UpdatePanel kontrol diperbarui atau dihapus.

public:
 void RegisterDispose(System::Web::UI::Control ^ control, System::String ^ disposeScript);

public void RegisterDispose(System.Web.UI.Control control, string disposeScript);

member this.RegisterDispose : System.Web.UI.Control * string -> unit

Public Sub RegisterDispose (control As Control, disposeScript As String)

Parameter

control

Control

Kontrol untuk dispose skrip.

disposeScript

String

Skripnya dispose .

Pengecualian

ArgumentNullException

control adalah null.

-atau-

disposeScript adalah null.

ArgumentException

control tidak ditemukan di halaman.

-atau-

control tidak berada di dalam UpdatePanel kontrol.

Keterangan

RegisterDispose Gunakan metode untuk mendaftarkan dispose skrip untuk kontrol yang berada di dalam UpdatePanel kontrol. Selama postback asinkron, UpdatePanel kontrol dapat diperbarui, dihapus, atau dibuat. Saat panel diperbarui atau dihapus, skrip apa pun dispose yang terdaftar untuk kontrol yang ada di dalam dipanggil UpdatePanel . Dalam skenario pengembangan halaman umum, Anda tidak perlu memanggil metode .RegisterDispose

Metode RegisterDispose ini ditujukan untuk digunakan oleh pengembang kontrol untuk mendaftarkan skrip atau membuat kontrol yang mewarisi dari IScriptControl antarmuka. Misalnya, Anda dapat menggunakan dispose skrip jika Anda mengembangkan kontrol klien dengan menggunakan komposisi. Dalam kontrol, Anda menerapkan IScriptControl dan merender kontrol individual. Anda mendaftarkan dispose metode item apa pun yang tidak sesuai dengan komponen klien yang ditentukan seperti Sys.TextBox. Jika kontrol kustom Anda menyusun elemen yang sesuai dengan komponen klien di Pustaka Ajax Microsoft, Anda tidak perlu mendaftarkan skrip dispose, karena dispose dipanggil secara otomatis. Oleh karena itu, gunakan metode RegisterDispose untuk komponen klien yang merupakan bagian dari pustaka Ajax Microsoft dan yang harus membebaskan sumber daya ketika komponen tidak lagi digunakan.

Metode RegisterDispose ini dapat dipanggil beberapa kali untuk kontrol. Beberapa skrip diagregasi. Urutan pembuangan skrip cocok dengan urutan di mana skrip didaftarkan.

Jika Anda mendaftarkan dispose skrip untuk kontrol yang tidak berada dalam UpdatePanel kontrol, pengecualian akan dilemparkan. dispose Skrip dipanggil antara pageLoading peristiwa pageLoaded dan PageRequestManager kelas.

Lihat juga

• IScriptControl