Класс Sys.Application

Предоставляет объект времени выполнения, который предоставляет клиентские события и управляет клиентскими компонентами, зарегистрированными с приложением. Элементы объекта доступны глобально после инициализации клиентского приложения. Элементы можно вызывать, не создавая экземпляр класса.

Пространство имен: Sys

Наследует: Sys.Component, Sys.IContainer

Sys.Application.addComponent(componentVar);

Имя

Описание

Конструктор Sys.Application

Инициализирует новый экземпляр класса Sys.Application.

Имя

Описание

Событие Sys.Application.init

Возникает после загрузки всех скриптов, но до создания объектов.

Событие Sys.Application.load

Возникает после загрузки всех скриптов и после создания и инициализации объектов в приложении.

Событие Sys.Application.navigate

Происходит при нажатии пользователем в обозревателе кнопок Назад или Вперед.

Событие Sys.Application.unload

Возникает до удаления всех объектов в клиентском приложении.

Метод Sys.Application.addComponent

Регистрирует компонент с приложением и инициализирует компонент, если он еще не инициализирован.

Метод Sys.Application.addHistoryPoint

Создает точку предыдущего состояния и добавляет ее в стек журнала обозревателя.

Метод Sys.Application.beginCreateComponents

Указывает приложению начать создавать компоненты.

Метод Sys.Application.beginUpdate

Вызывается методом Метод Sys.Application.beginUpdate для указания на то, что процесс установки свойств компонента приложения начался.

Метод Sys.Application.dispose

Высвобождает ресурсы и зависимости, хранящиеся в клиентском приложении.

Метод Sys.Application.disposeElement

Освобождает ресурсы и зависимости, связанные с элементом и его дочерними узлами.

Метод Sys.Application.endCreateComponents

Дает указание приложению закончить создание компонентов.

Метод Sys.Application.endUpdate

Вызывается методом Метод Sys.Application.endCreateComponents для указания на то, что процесс обновления приложения завершен.

Метод Sys.Application.findComponent

Возвращает указанный объект Sys.Component.

Метод Sys.Application $find

Предоставляет ярлык для метода findComponent.

Метод Sys.Application.getComponents

Возвращает массив всех компонентов, зарегистрированных с приложением с помощью метода addComponent.

Метод Sys.Application.initialize

Инициализирует приложение и вызывает событие load.

Метод Sys.Application.notifyScriptLoaded

Вызывается скриптом, на который имеется ссылка, для указания того, что скрипт загружен.

Метод Sys.Application.raiseLoad

Создает событие load.

Метод Sys.Application.raisePropertyChanged

Вызывает Событие Sys.INotifyPropertyChange.propertyChanged.

Метод Sys.Application.registerDisposableObject

При помощи приложения регистрирует объект, который требуется удалить.

Метод Sys.Application.removeComponent

Удаляет объект из приложения и уничтожает объект, если он может быть уничтожен.

Метод Sys.Application.unregisterDisposableObject

Отменяет регистрацию объекта в приложении.

Метод Sys.Application.updated

Вызывается Метод Sys.Application.endUpdate как как местозаполнитель дополнительной логики.

Свойство Sys.Application.enableHistory

Возвращает или задает значение, показывающее, поддерживает ли веб-приложение управление точками предыдущих состояний.

Свойство Sys.Application.isCreatingComponents

Возвращает значение, которое указывает, идет ли в приложении процесс создания компонентов.

Свойство Sys.Application.isDisposing

Получает значение, показывающее, находится ли приложение в процессе удаления своих ресурсов.

Объект Application предоставляет функции и события, поддерживающие разработку клиентских компонентов. Объект Application является единственным экземпляром закрытого класса Sys._Application. Объект Application создается, когда страница ASP.NET AJAX просматривается в обозревателе и сохраняется в течение всего срока существования страницы. Объект Application отвечает за вызов событий во время существования клиентской страницы, например таких событий как pageInit, pageLoad и pageUnload, а также за управление удалением зарегистрированных компонентов.

События

Объект Application предоставляет события init, load и unload, и он наследует события disposing и propertyChanged от базового класса Component. Все эти события применимы в течение жизненного цикла клиентского приложения в обозревателе.

Если поддерживается частичная отрисовка страницы, и страница содержит элемент управления UpdatePanel, класс PageRequestManager предоставляет дополнительные события, которые применяются к частям страницы, асинхронно подготавливаемым к просмотру. Дополнительные сведения о частичном выводе страницы для просмотра см. в разделе Общие сведения о частичной отрисовке страниц.

Отдельные компоненты могут предоставлять события, применимые только к компонентам. Они могут также обращаться к событиям на уровне приложения, используя объект Application.

В большинстве случаев разработчики страниц должны помещать свой код в событие load. В этот момент жизненного цикла страницы все скрипты загружены, и все компоненты созданы и готовы к использованию. Код, включенный в функцию pageLoad, будет автоматически выполняться при загрузке страницы.

Разработчики компонентов могут обращаться к другим событиям или привязывать дополнительные обработчики к событиям load или unload, вызывая метод доступа к событиям add_ и передавая функцию-обработчик. В следующем примере показано осуществление привязки функции myUnloadHandler к событию unload.

Sys.Application.add_unload(myUnloadHandler)

Если событие и его обработчики больше не нужны, можно вызвать метод доступа remove_, как показано в следующем примере:

Sys.Application.remove_unload(myUnloadHandler);

Можно прикрепить к событию дополнительные обработчики, вызывая метод доступа add_ один раз для каждого обработчика. Обработчики удаляются по отдельности при помощи вызова метода доступа remove_.

Дополнительные сведения о событиях Sys.Application см. в разделе События жизненного цикла клиента Ajax.

Добавление компонентов

В большинстве сценариев следует добавлять компоненты к приложению, используя команду $create . После регистрации компонента с приложением к нему можно обращаться в приложении, вызвав метод findComponent или ярлык $find. Список всех доступных компонентов можно получить, вызвав метод getComponents.

Дополнительные сведения о разработке компонентов, элементов управления и поведения см. в разделе Добавление функциональности Ajax к элементам управления ASP.NET.

Ссылки на файлы скриптов

Если выполняется ссылка на автономный файл скрипта (JS-файл) для использования с частичной отрисовкой страницы, код в файле скрипта может вызывать метод notifyScriptLoaded, однако он больше не требуется. Этот метод уведомляет приложение, что скрипт завершил загрузку. Дополнительные сведения см. в разделе Метод Sys.Application.notifyScriptLoaded.

Показ: