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

定義

名前空間:
System.Web.UI
アセンブリ:
System.Web.Extensions.dll

dispose コントロール内にあるコントロールのUpdatePanel スクリプトを登録します。 スクリプトは、 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 コントロールを更新、削除、または作成できます。 パネルが更新または削除されると、UpdatePanel内にあるコントロールに登録されているdisposeスクリプトが呼び出されます。 一般的なページ開発シナリオでは、 RegisterDispose メソッドを呼び出す必要はありません。

RegisterDispose メソッドは、スクリプトを登録したり、IScriptControl インターフェイスから継承するコントロールを作成したりするために、コントロール開発者が使用することを目的としています。 たとえば、コンポジションを使用してクライアント コントロールを開発する場合は、 dispose スクリプトを使用できます。 コントロールでは、 IScriptControl を実装し、個々のコントロールをレンダリングします。 Sys.TextBoxなどの定義済みのクライアント コンポーネントに対応しない項目のdispose メソッドを登録します。 カスタム コントロールが Microsoft Ajax Library のクライアント コンポーネントに対応する要素を構成する場合は、dispose が自動的に呼び出されるため、dispose スクリプトを登録する必要はありません。 そのため、Microsoft Ajax ライブラリの一部であり、コンポーネントが使用されなくなったときにリソースを解放する必要があるクライアント コンポーネントには、RegisterDispose メソッドを使用します。

RegisterDispose メソッドは、コントロールに対して複数回呼び出すことができます。 複数のスクリプトが集計されます。 スクリプトの破棄順序は、スクリプトが登録された順序と一致します。

UpdatePanel コントロールにないコントロールにdispose スクリプトを登録すると、例外がスローされます。 dispose スクリプトは、PageRequestManager クラスのpageLoadingイベントとpageLoaded イベントの間で呼び出されます。

適用対象

こちらもご覧ください