ScriptManager.RegisterDispose(Control, String) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
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 -> unitPublic Sub RegisterDispose (control As Control, disposeScript As String)Параметры
- control
- Control
Элемент управления, для которому dispose предназначен скрипт.
- disposeScript
- String
Скрипт dispose .
Исключения
Комментарии
RegisterDispose Используйте метод для регистрации dispose скриптов для элементов управления, находящихся внутри UpdatePanel элемента управления. Во время асинхронной обратной передачи UpdatePanel элементы управления можно обновлять, удалять или создавать. При обновлении или удалении панели вызываются все dispose скрипты, зарегистрированные для элементов управления, находящихся внутри них UpdatePanel . В типичных сценариях разработки страниц не требуется вызывать RegisterDispose метод.
Метод RegisterDispose предназначен для использования разработчиками элементов управления для регистрации скрипта или создания элементов управления, наследуемых IScriptControl от интерфейса. Например, можно использовать скрипт, если вы разрабатываете клиентский dispose элемент управления с помощью композиции. В элементе управления вы реализуете и отрисовываете IScriptControl отдельные элементы управления. Вы регистрируете dispose метод любого элемента, который не соответствует определенному клиентскому компоненту, например Sys.TextBox. Если пользовательский элемент управления создает элементы, соответствующие клиентским компонентам в библиотеке Microsoft Ajax, вам не нужно регистрировать скрипт dispose, так как dispose вызывается автоматически. Поэтому используйте метод RegisterDispose для клиентских компонентов, которые являются частью библиотеки Ajax Microsoft и которые должны освободить ресурсы, если компонент больше не используется.
Метод RegisterDispose можно вызывать несколько раз для элемента управления. Несколько сценариев агрегируются. Порядок удаления скриптов соответствует порядку регистрации скриптов.
Если вы регистрируете dispose скрипт для элемента управления, который не находится в элементе UpdatePanel управления, создается исключение. Скрипт dispose вызывается между pageLoading и pageLoaded событиями PageRequestManager класса.
