Sys.Application, classe

Mise à jour : novembre 2007

Fournit un objet au moment de l'exécution qui expose les événements clients et gère les composants clients inscrits avec l'application. Les membres de cet objet sont disponibles globalement après l'initialisation de l'application cliente. Les membres peuvent être appelés sans créer d'instance de la classe.

Espace de noms : Sys

Hérite de : Sys.Component, Sys.IContainer

Sys.Application.addComponent(componentVar);

Constructeurs

Nom	Description
Sys.Application, constructeur	Initialise une nouvelle instance de la classe Sys.Application.

Membres

Nom	Description
Sys.Application.init, événement	Déclenché après que tous les scripts ont été chargés mais avant la création des objets.
Sys.Application.load, événement	Déclenché après que tous les scripts ont été chargés et après que les objets de l'application ont été créés et initialisés.
Sys.Application.navigate, événement	Se produit lorsque l'utilisateur clique sur le bouton Précédent ou Suivant du navigateur.
Sys.Application.unload, événement	Déclenché avant que tous les objets de l'application cliente soient supprimés.
Sys.Application.addComponent, méthode	Inscrit un composant avec l'application et l'initialise si le composant n'est pas déjà initialisé.
Sys.Application.addHistoryPoint, méthode	Crée un point d'historique et l'ajoute à la pile d'historique du navigateur.
Sys.Application.beginCreateComponents, méthode	Indique à l'application de commencer à créer des composants.
Sys.Application.beginUpdate, méthode	Appelé par la méthode Sys.Application.beginUpdate pour indiquer que le processus de définition des propriétés de composant de l'application a commencé.
Sys.Application.dispose, méthode	Libère des ressources et des dépendances détenues par l'application cliente.
Sys.Application.endCreateComponents, méthode	Indique à l'application de finaliser la création du composant.
Sys.Application.endUpdate, méthode	Appelé par la méthode Sys.Application.endCreateComponents pour indiquer que le processus de mise à jour de l'application est terminé.
Sys.Application.findComponent, méthode	Retourne l'objet Sys.Component spécifié.
$find, méthode de Sys.Application	Fournit un raccourci vers la méthode findComponent.
Sys.Application.getComponents, méthode	Retourne un tableau de tous les composants inscrits avec l'application par le biais de la méthode addComponent.
Sys.Application.initialize, méthode	Initialise l'application et déclenche l'événement load.
Sys.Application.notifyScriptLoaded, méthode	Appelé par un script référencé pour indiquer que le script a été chargé.
Sys.Application.queueScriptReference, méthode	Met séquentiellement en file d'attente les scripts à charger dans l'ordre de la file d'attente.
Sys.Application.raiseLoad, méthode	Déclenche l'événement load.
Sys.Application.raisePropertyChanged, méthode	Déclenche l'événement Sys.INotifyPropertyChange.propertyChanged.
Sys.Application.registerDisposableObject, méthode	Inscrit un objet qui devra être supprimé avec l'application.
Sys.Application.removeComponent, méthode	Enlève l'objet de l'application et le supprime s'il est supprimable.
Sys.Application.unregisterDisposableObject, méthode	Annule l'inscription d'un objet supprimable de l'application.
Sys.Application.updated, méthode	Appelé par la méthode Sys.Application.endUpdate comme un espace réservé pour la logique supplémentaire.
Sys.Application.enableHistory, propriété	Obtient ou définit une valeur qui indique si l'application Web prend en charge la gestion des points d'historique.
Sys.Application.isCreatingComponents, propriété	Obtient une valeur qui indique si l'application est en train de créer des composants.

Notes

L'objet Application fournit des fonctions et événements qui prennent en charge le développement de composant de client. L'objet Application est une instance unique de la classe Sys._Application privée. L'objet Application est créé lorsqu'une page ASP.NET AJAX est affichée dans le navigateur et persiste pendant la durée de vie de la page. L'objet Application est chargé de déclencher des événements de cycle de vie de la page cliente tels que pageInit, pageLoad, pageUnload et pour gérer la suppression de composants inscrits.

Événements

L'objet Application fournit les événements init, load et unload, et il hérite des événements disposing et propertyChanged de la classe de base Component. Tous ces événements s'appliquent au cycle de vie de l'application cliente dans le navigateur.

Si le rendu de page partielle est pris en charge et que la page contient un contrôle UpdatePanel, la classe PageRequestManager fournit des événements supplémentaires qui s'appliquent aux parties de la page restituées de façon asynchrone. Pour plus d'informations sur le rendu de page partielle, consultez Vue d'ensemble du rendu de page partielle.

Les composants individuels peuvent exposer des événements qui s'appliquent uniquement au composant. Ils peuvent également accéder aux événements au niveau de l'application en utilisant l'objet Application.

Dans la plupart des cas, les développeurs de pages doivent placer leur code dans l'événement load. À ce stade du cycle de vie de la page, tous les scripts sont chargés et tous les composants ont été créés et sont prêts à l'emploi. Tout code inclus dans une fonction nommée pageLoad s'exécutera automatiquement lors du chargement de la page.

Les développeurs de composants peuvent accéder à d'autres événements ou lier des gestionnaires supplémentaires aux événements load ou unload en appelant la méthode d'accesseur de l'événement add_ et en passant la fonction gestionnaire. L'exemple suivant indique comment lier une fonction nommée myUnloadHandler à l'événement unload.

Sys.Application.add_unload(myUnloadHandler)

Lorsqu'un événement et ses gestionnaires ne sont plus utiles, vous pouvez appeler la méthode d'accesseur remove_, comme dans l'exemple suivant :

Sys.Application.remove_unload(myUnloadHandler);

Vous pouvez joindre des gestionnaires supplémentaires à un événement en appelant l'accesseur add_ une fois pour chaque gestionnaire. Les gestionnaires sont supprimés individuellement en appelant la méthode d'accesseur remove_.

Pour plus d'informations sur les événements Sys.Application, consultez Événements de cycle de vie client AJAX.

Ajout de composants

Dans la plupart des scénarios, vous devez ajouter des composants à une application en utilisant la commande $create . Après avoir inscrit un composant auprès de l'application, vous pouvez y accéder dans l'application en appelant la méthode findComponent ou le raccourci $find. Vous pouvez obtenir une liste de tous les composants disponibles en appelant la méthode getComponents.

Pour plus d'informations sur le développement de composants, contrôles et comportements clients, consultez Ajout de fonctionnalités AJAX à des contrôles ASP.NET.

Référencement de fichiers de script

Si vous référencez un fichier de script autonome (fichier .js) pour une utilisation avec le rendu de page partielle, le code dans le fichier de script doit appeler la méthode notifyScriptLoaded. Ceci indique à l'application que le script a fini le chargement. Pour plus d'informations, consultez Sys.Application.notifyScriptLoaded, méthode.

Voir aussi

Référence

new, opérateur

Autres ressources

Référence du langage