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事件pageLoaded之间PageRequestManager调用。

适用于

另请参阅