ScriptManager.RegisterDispose(Control, String) ScriptManager.RegisterDispose(Control, String) ScriptManager.RegisterDispose(Control, String) Method

Определение

Регистрирует скрипт dispose для элемента управления, находящегося внутри элемента управления UpdatePanel.Registers a dispose script for a control that is inside an UpdatePanel control. Скрипт выполняется, когда элемент управления UpdatePanel изменяется или удаляется.The script is executed when the UpdatePanel control is updated or deleted.

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

Параметры

control
Control Control Control

Элемент управления, для которого предназначен скрипт dispose.The control that the dispose script is for.

disposeScript
String String String

Скрипт dispose.The dispose script.

Исключения

Свойство control имеет значение null.control is null.

- или --or- disposeScriptnull.disposeScript is null.

Элемент управления control не найден на странице.control is not found on the page.

- или --or- Элемент управления control не находится внутри элемента управления UpdatePanel.control is not inside an UpdatePanel control.

Комментарии

Используйте метод для регистрации dispose скриптов для UpdatePanel элементов управления, находящихся внутри элемента управления. RegisterDisposeUse the RegisterDispose method to register dispose scripts for controls that are inside an UpdatePanel control. Во время асинхронных обратных UpdatePanel передач элементы управления могут быть обновлены, удалены или созданы.During asynchronous postbacks, UpdatePanel controls can be updated, deleted, or created. При обновлении или удалении панели вызываются все dispose скрипты, зарегистрированные для элементов управления, находящихся UpdatePanel внутри.When a panel is updated or deleted, any dispose scripts that are registered for controls that are inside the UpdatePanel are called. В типичных сценариях разработки страниц нет необходимости вызывать RegisterDispose метод.In typical page development scenarios, you do not have to call the RegisterDispose method.

Метод предназначен для использования разработчиками элементов управления для регистрации скрипта или создания элементов управления, которые наследуются IScriptControl от интерфейса. RegisterDisposeThe RegisterDispose method is intended for use by control developers to register script or create controls that inherit from the IScriptControl interface. Например, dispose сценарий можно использовать при разработке клиентского элемента управления с помощью компоновки.For example, you might use a dispose script if you develop a client control by using composition. В вашем элементе управления реализуются IScriptControl и визуализируются отдельные элементы управления.In your control, you implement IScriptControl and render individual controls. Вы регистрируете dispose метод любого элемента, который не соответствует определенному клиентскому компоненту, Sys.TextBoxнапример.You register the dispose method of any item that does not correspond to a defined client component such as Sys.TextBox. Если пользовательский элемент управления создает элементы, соответствующие клиентским компонентам в библиотеке Microsoft AJAX, нет необходимости регистрировать dispose скрипт, так как dispose вызывается автоматически.If your custom control composes elements that correspond to client components in the Microsoft Ajax Library, you do not have to register a dispose script, because dispose is called automatically. Поэтому используйте RegisterDispose метод для клиентских компонентов, которые являются частью библиотеки Microsoft AJAX и должны освобождать ресурсы, если компонент больше не используется.Therefore, use the RegisterDispose method for client components that are part of the Microsoft Ajax Library and that have to free resources when a component is no longer used.

RegisterDispose Метод можно вызывать несколько раз для элемента управления.The RegisterDispose method can be called multiple times for a control. Выполняется статистическая обработка нескольких скриптов.Multiple scripts are aggregated. Порядок удаления скриптов совпадает с порядком, в котором были зарегистрированы сценарии.The order of disposing scripts matches the order in which the scripts were registered.

При регистрации dispose скрипта для элемента управления, который не находится UpdatePanel в элементе управления, возникает исключение.If you register a dispose script for a control that is not in an UpdatePanel control, an exception is thrown. Скрипт вызывается pageLoading между pageLoaded событиямиPageRequestManagerикласса. disposeThe dispose script is called between the pageLoading and pageLoaded events of the PageRequestManager class.

Применяется к

Дополнительно