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 可以更新、删除或创建控件。 更新或删除面板时，将调用为内部UpdatePanel控件注册的任何dispose脚本。 在典型的页面开发方案中，无需调用该方法 RegisterDispose 。

该方法 RegisterDispose 供控件开发人员使用，用于注册脚本或创建从接口继承的 IScriptControl 控件。 例如，如果使用合成开发客户端控件，则可以使用 dispose 脚本。 在控件中，实现 IScriptControl 和呈现单个控件。 dispose注册与定义的客户端组件（例如Sys.TextBox）不对应的任何项的方法。 如果自定义控件组成与 Microsoft Ajax 库中客户端组件对应的元素，则无需注册 dispose 脚本，因为 dispose 会自动调用。 因此，对 RegisterDispose 属于 Microsoft Ajax 库的客户端组件使用该方法，并且当不再使用组件时必须释放资源。

RegisterDispose可以为控件多次调用该方法。 聚合多个脚本。 释放脚本的顺序与注册脚本的顺序匹配。

如果为不在控件中的UpdatePanel控件注册dispose脚本，则会引发异常。 该dispose脚本在类的事件PageRequestManager之间pageLoading``pageLoaded调用。

另请参阅

• IScriptControl