Sys.Application 类

项目
09/04/2008

更新：2007 年 11 月

提供一个运行时对象，该对象公开客户端事件并管理向应用程序注册的客户端组件。此对象的成员在初始化客户端应用程序后全局可用。这些成员可在不创建类实例的情况下调用。

命名空间：Sys

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 属性	获取或设置一个值，该值指示 Web 应用程序是否支持历史时间点管理。
Sys.Application.isCreatingComponents 属性	获取一个值，该值指示应用程序是否正在创建组件。

备注

Application 对象提供支持客户端组件开发的函数和事件。Application 对象是 Sys._Application 私有类的单个实例。Application 对象是在浏览器中显示 ASP.NET AJAX 页面时创建的，将在该页面的生存期内持续存在。Application 对象负责引发客户端页面生命周期事件（例如 pageInit、pageLoad 和 pageUnload），并负责管理已注册组件的释放。

事件

Application 对象提供 init、load 和 unload 事件，它从 Component 基类继承 disposing 和 propertyChanged 事件。所有这些事件在浏览器中客户端应用程序的生命周期内适用。

如果支持部分页呈现，并且页面包含 UpdatePanel 控件，则 PageRequestManager 类提供应用于异步呈现的部分页的其他事件。有关部分页呈现的更多信息，请参见部分页呈现概述。

单个组件可以公开仅应用于组件的事件。它们还可以使用 Application 对象访问应用程序级别的事件。

在大多数情况下，网页开发人员应将代码放入 load 事件中。在页面生命周期的某个时间点，将加载所有脚本，并且所有组件都已创建完毕准备使用。名为 pageLoad 的函数中的所有代码将在页面加载时自动运行。

组件开发人员可以通过调用事件的 add_ 访问器方法和传递处理程序函数，来访问其他事件或将其他处理程序绑定到 load 或 unload 事件。下面的示例演示如何将一个名为 myUnloadHandler 的函数绑定到 unload 事件。

Sys.Application.add_unload(myUnloadHandler)

当不再需要某个事件及其处理程序时，可以调用 remove_ 访问器方法，如下面的示例所示：

Sys.Application.remove_unload(myUnloadHandler);

可以通过为每个处理程序调用一次 add_ 访问器，将其他处理程序附加到事件。可以通过调用 remove_ 访问器方法逐个移除处理程序。

有关 Sys.Application 事件的更多信息，请参见 AJAX 客户端生命周期事件。

添加组件

大多数情况下，应使用 $create 命令将组件添加到应用程序。在组件已经向应用程序注册后，可以通过调用 findComponent 方法或 $find 快捷方式，在应用程序中访问该组件。可以通过调用 getComponents 方法获取所有可用组件的列表。

有关如何开发组件、控件和行为的更多信息，请参见向 ASP.NET 控件添加 AJAX 功能。

引用脚本文件

如果引用独立脚本文件（.js 文件）用于部分页呈现，则脚本文件中的代码必须调用 notifyScriptLoaded 方法。这将通知应用程序：脚本已经完成加载。有关更多信息，请参见 Sys.Application.notifyScriptLoaded 方法。

Sys.Application 类

构造函数

成员

备注

事件

添加组件

引用脚本文件

请参见

参考

其他资源

其他资源