Класс 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.

См. также

Другие ресурсы

Справочник по языку