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使用 方法來註冊 dispose 控制項內的 UpdatePanel 控制項腳本。 在非同步回傳期間， UpdatePanel 可以更新、刪除或建立控制項。 更新或刪除面板時，會呼叫針對 內 UpdatePanel 控制項註冊的任何 dispose 腳本。 在一般頁面開發案例中，您不需要呼叫 RegisterDispose 方法。

方法 RegisterDispose 可供控制項開發人員用來註冊腳本，或建立繼承自 介面的 IScriptControl 控制項。 例如，如果您使用組合來開發用戶端控制項，您可能會使用 dispose 腳本。 在您的控制項中，您會實 IScriptControl 作和轉譯個別控制項。 您可以註冊 dispose 任何未對應至已定義用戶端元件的專案方法，例如 Sys.TextBox 。 如果您的自訂控制項會撰寫對應至 Microsoft Ajax Library 中用戶端元件的元素，就不需要註冊 dispose 腳本，因為 dispose 會自動呼叫 。 因此，針對屬於 Microsoft Ajax Library 的用戶端元件使用 RegisterDispose 方法，而且在不再使用元件時必須釋放資源。

RegisterDispose您可以多次呼叫 控制項的方法。 匯總多個腳本。 處置腳本的順序符合註冊腳本的順序。

如果您為不在 控制項中的 UpdatePanel 控制項註冊 dispose 腳本，則會擲回例外狀況。 腳本 dispose 會在 類別的 PageRequestManager 和 pageLoaded 事件之間 pageLoading 呼叫。

另請參閱

• IScriptControl