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 控制項可以被更新、刪除或建立。 當面板更新或刪除時，會 dispose 呼叫所有已註冊為控制項的 UpdatePanel 腳本。 在典型的頁面開發情境中，你不必呼叫這個 RegisterDispose 方法。

此 RegisterDispose 方法旨在供控制開發者註冊腳本或建立繼承 IScriptControl 介面控制項的使用。 例如，如果你透過合成來開發客戶端控制，可能會使用 dispose 腳本。 在你的控制中，你可以實作 IScriptControl 並渲染個別控制。 你註冊任何不對應於定義客戶端元件（如 dispose）的項目的方法Sys.TextBox。 如果你的自訂控制項組合了對應 Microsoft Ajax 函式庫中客戶端元件的元素，你就不必註冊 dispose 腳本，因為 dispose 會自動呼叫。 因此，對於屬於 Microsoft Ajax 函式庫且在元件不再使用時必須釋放資源的客戶元件，請使用 RegisterDispose 方法。

此 RegisterDispose 方法可多次呼叫以對照項。 多個腳本會被聚合。 處置處置順序與處置順序相符。

如果你註冊 dispose 了一個不在控制 UpdatePanel 中的控制項腳本，會拋出例外。 dispose該腳本在類別的事件pageLoading之間pageLoadedPageRequestManager被呼叫。

另請參閱

• IScriptControl