Sys.Application 类
更新:2007 年 11 月
提供一个运行时对象,该对象公开客户端事件并管理向应用程序注册的客户端组件。此对象的成员在初始化客户端应用程序后全局可用。这些成员可在不创建类实例的情况下调用。
命名空间:Sys
继承: Sys.Component、Sys.IContainer
Sys.Application.addComponent(componentVar);
构造函数
名称 |
说明 |
---|---|
初始化 Sys.Application 类的新实例。 |
成员
名称 |
说明 |
---|---|
在加载所有脚本之后,创建对象之前引发。 |
|
在已加载所有脚本且已创建并初始化应用程序中的对象时引发。 |
|
在用户单击浏览器的“后退”或“前进”按钮时发生。 |
|
在释放客户端应用程序中的所有对象之前引发。 |
|
向应用程序注册组件,如果组件未初始化,则将其初始化。 |
|
创建一个历史时间点,并将其添加到浏览器的历史记录堆栈中。 |
|
指示应用程序开始创建组件。 |
|
由 Sys.Application.beginUpdate 方法调用,以指示设置应用程序组件属性的过程已开始。 |
|
释放客户端应用程序持有的资源和依赖项。 |
|
指示应用程序完成组件创建。 |
|
由 Sys.Application.endCreateComponents 方法调用,以指示更新应用程序的过程已完成。 |
|
返回指定的 Sys.Component 对象。 |
|
提供 findComponent 方法的快捷方式。 |
|
返回已通过 addComponent 方法向应用程序注册的所有组件的数组。 |
|
初始化应用程序并引发 load 事件。 |
|
由引用的脚本调用,用于指示已经加载此脚本。 |
|
按顺序将要以排队顺序加载的脚本排入队列。 |
|
引发 load 事件。 |
|
注册一个将要求从应用程序中释放的对象。 |
|
从应用程序中移除对象并释放该对象(如果该对象可释放)。 |
|
从应用程序中注销可释放对象。 |
|
由 Sys.Application.endUpdate 方法将其作为附加逻辑的占位符来调用。 |
|
获取或设置一个值,该值指示 Web 应用程序是否支持历史时间点管理。 |
|
获取一个值,该值指示应用程序是否正在创建组件。 |
备注
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 方法。