Sys.Application (Clase)
Actualización: noviembre 2007
Proporciona un objeto en tiempo de ejecución que expone los eventos de cliente y administra los componentes de cliente que se registran con la aplicación. Los miembros de este objeto están disponibles globalmente una vez inicializada la aplicación cliente. Los miembros se pueden invocar sin crear una instancia de la clase.
Espacio de nombres: Sys
Hereda: Sys.Component, Sys.IContainer
Sys.Application.addComponent(componentVar);
Constructores
Nombre |
Descripción |
|---|---|
Inicializa una nueva instancia de la clase Sys.Application. |
Members
Nombre |
Descripción |
|---|---|
Se provoca una vez cargados todos los scripts pero antes de que se cree ningún objeto. |
|
Se provoca una vez cargados todos los scripts y una vez creados e inicializados los objetos en la aplicación. |
|
Se provoca cuando el usuario hace clic en el botón Atrás o Adelante del explorador. |
|
Se provoca antes de que se eliminen todos los objetos de la aplicación cliente. |
|
Registra un componente con la aplicación y lo inicializa si no se ha inicializado todavía. |
|
Crea un punto del historial y lo agrega a la pila del historial del explorador. |
|
Indica a la aplicación que inicie la creación de componentes. |
|
Llamado por el método Sys.Application.beginUpdate para indicar que se ha iniciado el proceso de establecimiento de las propiedades de los componentes de la aplicación. |
|
Libera los recursos y dependencias que mantiene la aplicación cliente. |
|
Indica a la aplicación que finalice la creación de componentes. |
|
Lo llama el método Sys.Application.endCreateComponents para indicar que se ha completado el proceso de actualización de la aplicación. |
|
Devuelve el objeto Sys.Component especificado. |
|
Proporciona un acceso directo al método findComponent. |
|
Devuelve una matriz de todos los componentes registrados con la aplicación a través del método addComponent. |
|
Inicializa la aplicación y provoca el evento load. |
|
Lo llama un script al que se hace referencia para indicar que el script se ha cargado. |
|
Pone en cola secuencialmente los scripts que se van a cargar en el orden de la cola. |
|
Provoca el evento load |
|
Provoca el evento Sys.INotifyPropertyChange.propertyChanged. |
|
Registra un objeto que requerirá ser eliminado con la aplicación. |
|
Quita el objeto de la aplicación y lo elimina si es posible. |
|
Anula el registro de un objeto descartable en la aplicación. |
|
Lo llama el método Sys.Application.endUpdate como marcador de posición para incluir lógica adicional. |
|
Obtiene o establece un valor que indica si la aplicación web admite la administración de puntos del historial. |
|
Obtiene un valor que indica si la aplicación está creando componentes. |
Comentarios
El objeto Application proporciona funciones y eventos que permiten el desarrollo de componentes cliente. El objeto Application es una instancia única de la clase Sys._Application privada. El objeto Application se crea cuando una página AJAX de ASP.NET se consulta en el explorador y se conserva durante el ciclo de vida de la página. El objeto Application es responsable de provocar eventos del ciclo de vida de la página como pageInit, pageLoady pageUnload y de administrar la eliminación de los componentes registrados.
Eventos
El objeto Application proporciona los eventos init, load y unload, y hereda los eventos disposing y propertyChanged de la clase Component base. Todos estos eventos se aplican al ciclo de vida de la aplicación cliente en el explorador.
Si se admite el procesamiento parcial de páginas y la página contiene un control UpdatePanel, la clase PageRequestManager proporciona eventos adicionales que se aplican a las partes de la página que se representan de forma asincrónica. Para obtener más información acerca de la representación parcial de páginas, vea Información general sobre la representación parcial de páginas.
Los componentes individuales pueden exponer eventos que sólo se apliquen al componente. También pueden tener acceso a los eventos de nivel de aplicación mediante el objeto Application.
Normalmente, los desarrolladores de páginas deberán colocar su código en el evento load. En ese punto del ciclo de vida de la página, todos los scripts están cargados y todos los componentes se han creado y se pueden utilizar. Todo el código que se incluya en una función denominada pageLoad se ejecutará automáticamente cuando se cargue la página.
Los programadores de componentes pueden tener acceso a otros eventos o enlazar controladores adicionales a los eventos load o unload invocando el método de descriptor de acceso del evento add_ y pasando la función del controlador. En el siguiente ejemplo se muestra cómo enlazar una función denominada myUnloadHandler al evento unload.
Sys.Application.add_unload(myUnloadHandler)
Cuando ya no se necesite un evento ni sus controladores, puede llamar al método de descriptor de acceso remove_, como en el ejemplo siguiente:
Sys.Application.remove_unload(myUnloadHandler);
Puede asociar controladores adicionales a un evento llamando al descriptor de acceso add_ una vez para cada controlador. Los controladores se quitan individualmente llamando al método de descriptor de acceso remove_.
Para obtener más información sobre los eventos Sys.Application, vea Eventos de ciclo de vida de cliente de AJAX.
Agregar componentes
En la mayoría de las situaciones, deberá agregar los componentes a una aplicación mediante el comando $create . Una vez registrado un componente con la aplicación, puede tener acceso a él en la aplicación llamando al método findComponent o al método abreviado $find. Puede obtener una lista de todos los componentes disponibles llamando al método getComponents.
Para obtener más información sobre cómo desarrollar componentes, controles y comportamientos, vea Agregar la funcionalidad de AJAX a los controles ASP.NET.
Referencia a archivos de script
Si hace referencia a un archivo de script independiente (archivo .js) para que se use en la representación parcial de páginas, el código del archivo de script debe llamar al método notifyScriptLoaded. De esta forma, se notificará a la aplicación que el script se ha terminado de cargar. Para obtener más información, consulte Sys.Application.notifyScriptLoaded (Método).