Application Class

Encapsule l'application et ses services disponibles.

Héritage

Object
  Application

Syntaxe


public class Application : Object

Attributs

MarshalingBehaviorAttribute(Agile)
StaticAttribute(Windows.UI.Xaml.IApplicationStatics, NTDDI_WIN8)
ThreadingAttribute(Both)
VersionAttribute(NTDDI_WIN8)
WebHostHiddenAttribute()

Membres

ApplicationClasse comporte les types de membres suivants :

Constructeurs

ApplicationClasse comporte les constructeurs suivants.

ConstructeurDescription
Application Initializes a new instance of the Application class.

 

Événements

ApplicationClasse comporte les événements suivants.

ÉvénementDescription
Resuming Occurs when the application transitions from Suspended state to Running state.
Suspending Occurs when the application transitions to Suspended state from some other state.
UnhandledException Occurs when an exception is raised by application code, forwarded from the native level. Applications can mark the occurrence as handled in event data.

 

Méthodes

The Application Classe comporte les méthodes suivantes. Il hérite également des méthodes de Object Classe.

MéthodeDescription
Exit Shuts down the app.
LoadComponent(Object, Uri) Loads a XAML file that is located at the specified relative location, and converts it to an instance of the object that is specified by the root element of the XAML file.
LoadComponent(Object, Uri, ComponentResourceLocation) Loads a XAML file that is located at the specified relative location, and converts it to an instance of the object that is specified by the root element of the XAML file.
OnActivated Invoked when the application is activated by some means other than normal launching.
OnCachedFileUpdaterActivated Invoked when the application is activated due to an activation contract with ActivationKind as CachedFileUpdater.
OnFileActivated Invoked when the application is activated through file-open.
OnFileOpenPickerActivated Invoked when the application is activated through file-open dialog association.
OnFileSavePickerActivated Invoked when the application is activated through file-save dialog association.
OnLaunched Invoked when the application is launched. Override this method to perform application initialization and to display initial content in the associated Window.
OnSearchActivated Invoked when the application is activated through a search association.
OnShareTargetActivated Invoked when the application is activated through sharing association.
OnWindowCreated Invoked when the application creates a window.
Start Provides the entry point and requests initialization of the application. Use the callback to instantiate the Application class.

 

Propriétés

Le ApplicationClasse contient les propriétés suivantes.

PropriétéType d’accèsDescription

Current

en lecture seuleGets the Application object for the current application.

DebugSettings

en lecture seuleGets an object that declares how the app behaves when run in a debug environment.

RequestedTheme

en lecture/écritureGets or sets a value that determines the light-dark preference for the overall theme of an app.

Resources

en lecture/écritureGets a collection of application-scoped resources, such as styles, templates, and brushes.

 

Remarques

La classe Application encapsule une application et fournit les services suivants :

  • point d'entrée de l'application
  • gestion de la durée de vie de l'application
  • ressources de portée application
  • détection d'exception non gérée

L'objet Application est généralement fourni dans le XAML initial pour App.xaml. Les modèles de projet par défaut dans Visual Studio génèrent une classe App qui dérive d'Application et fournit un point d'entrée auquel vous pouvez ajouter le code d'initialisation.

La classe App s'associe avec le code XAML correspondant en appelant la méthode InitializeComponent générée dans son constructeur. Vous pouvez ajouter du code d'initialisation supplémentaire au constructeur App, mais vous ajouterez en général uniquement du code pour associer les gestionnaires aux événements Application. Pour un autre code d'initialisation, vous devez remplacer une ou plusieurs méthodes d'initialisation, comme OnLaunched.

Le système gère la durée de vie d'une application en l'interrompant chaque fois que l'utilisateur bascule vers une autre application ou vers le Bureau et en la reprenant chaque fois que l'utilisateur retourne vers elle. Toutefois, le système peut également arrêter votre application pendant qu'elle est interrompue afin de libérer des ressources. Vous devez gérer l'événement Suspending pour enregistrer l'état de votre application en cas de arrêt, puis remplacer la méthode OnLaunched pour restaurer l'état de votre application. Vous devez gérer l'événement de reprise uniquement si vous devez actualiser tout contenu affiché qui a pu changé pendant l'interruption de l'application. Vous n'avez pas besoin de restaurer l'autre état de l'application lorsque l'application reprend.

En raison de son emplacement dans le modèle d'application, le codegen et la séquence d'activation, Application présente quelques restrictions sur l'utilisation XAML :

  • Hormis les déclarations xmlns, aucun autre attribut ne peut apparaître sur la balise racine Application. En particulier, x:Class n'est pas pris en charge ; la classe associée à utiliser pour codegen est générée par les paramètres du projet.
  • Les auteurs d'application ne doivent pas connecter Application aux gestionnaires d'événements dans le codage XAML. Toute connexion d'événements doit être effectuée dans le code. De plus, vous utilisez généralement des substitutions de méthode plutôt qu'un événement (par exemple, vous substituez OnActivated pour répondre à cette phase du cycle de vie de l'application.)
  • Les seuls jeux de propriétés attendus sur Application en XAML alimentent la propriété Resources à l'aide d'une utilisation d'élément de propriété XAML. Pour plus d'informations, consultez Resources.

Pour fournir une gestion globale des erreurs pour toutes les exceptions que votre code d'application n'intercepte pas, gérez l'événement UnhandledException.

Remarque  Le fichier principal Application doit être nommé App.xaml.

Configuration requise

Client minimal pris en charge

Windows 8 [Applications du Windows Store uniquement]

Serveur minimal pris en charge

Windows Server 2012 [Applications du Windows Store uniquement]

Espace de noms

Windows.UI.Xaml
Windows::UI::Xaml [C++]

Métadonnées

Windows.winmd

Voir aussi

Comment activer une application
Comment suspendre une application
Comment reprendre une application

 

 

Afficher:
© 2014 Microsoft