ScriptManager.RegisterDispose(Control, String) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
UpdatePanel コントロール内にあるコントロールに対して dispose
スクリプトを登録します。 このスクリプトは、UpdatePanel コントロールが更新または削除されるときに実行されます。
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)
パラメーター
- control
- Control
dispose
スクリプトの目的のコントロール。
- disposeScript
- String
dispose
スクリプト。
例外
注釈
このメソッドをRegisterDispose使用して、コントロール内にあるコントロールのスクリプトをUpdatePanel登録dispose
します。 非同期ポストバック中は、 UpdatePanel コントロールを更新、削除、または作成できます。 パネルが更新または削除されると、 dispose
その内部 UpdatePanel にあるコントロールに登録されているスクリプトが呼び出されます。 一般的なページ開発シナリオでは、メソッドを呼び出す RegisterDispose 必要はありません。
このメソッドは RegisterDispose 、コントロール開発者がスクリプトを登録したり、インターフェイスから継承するコントロールを作成したりするために使用することを IScriptControl 目的としています。 たとえば、コンポジションを dispose
使用してクライアント コントロールを開発する場合は、スクリプトを使用できます。 コントロールでは、個々のコントロールを実装 IScriptControl してレンダリングします。 定義Sys.TextBox
されたdispose
クライアント コンポーネントに対応しない項目のメソッドを登録します。 カスタム コントロールが Microsoft Ajax ライブラリのクライアント コンポーネントに対応する要素を構成する場合は、スクリプトを登録 dispose
する必要はありません。これは自動的に呼び出されるため dispose
です。 したがって、Microsoft Ajax ライブラリの一部であり、コンポーネントが使用 RegisterDispose されなくなったときにリソースを解放する必要があるクライアント コンポーネントには、このメソッドを使用します。
このメソッドは RegisterDispose 、コントロールに対して複数回呼び出すことができます。 複数のスクリプトが集計されます。 スクリプトの破棄順序は、スクリプトが登録された順序と一致します。
コントロールにないUpdatePanelコントロールのスクリプトを登録dispose
すると、例外がスローされます。 スクリプトはdispose
、クラスのイベントのpageLoaded
間でpageLoading``PageRequestManager
呼び出されます。