Класс Sys.Application

Статья
11/16/2008

Обновлен: Ноябрь 2007

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

Пространство имен: 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.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.queueScriptReference	Последовательно ставит в очередь сценарии, которые должны загружаться в порядке очереди.
Метод 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	Получает значение, показывающее, находится ли приложение в процессе создания компонентов.

Заметки

Объект 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.

Класс Sys.Application

Конструкторы

Члены

Заметки

События

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

Ссылки на файлы сценариев

См. также

Ссылки

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

Дополнительные ресурсы