ScriptManager.RegisterDispose(Control, String) メソッド

定義

名前空間:

System.Web.UI

アセンブリ:

System.Web.Extensions.dll

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 スクリプト。

例外

ArgumentNullException

control が nullです。

または disposeScript が nullです。

ArgumentException

control がページ上で見つかりません。

• または - control が UpdatePanel コントロール内にありません。

注釈

このメソッドを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呼び出されます。

こちらもご覧ください

• IScriptControl