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