Application Classe

Référence

Définition

Espace de noms:: Windows.UI.Xaml

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

Encapsule l’application et ses services disponibles.

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Application

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class Application

Public Class Application

<Application />

Héritage: Object IInspectable Application

Attributs: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Remarques

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

point d’entrée d’application, en particulier pour les différents contrats d’activation
gestion de la durée de vie des applications
ressources étendues à l’application
détection d’exception non gérée

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

La App classe s’associe au code XAML correspondant en appelant la méthode générée InitializeComponent dans son constructeur. Vous pouvez ajouter du code d’initialisation supplémentaire au App constructeur, mais vous n’ajouterez généralement que du code pour associer des gestionnaires aux événements d’application. Pour un autre code d’initialisation, vous devez remplacer une ou plusieurs méthodes d’initialisation telles que OnLaunched.

Le système gère la durée de vie de l’application en suspendant votre application chaque fois que l’utilisateur bascule vers une autre application ou sur le bureau, et en reprenant votre application chaque fois que l’utilisateur y revient. Toutefois, le système peut également arrêter votre application pendant sa suspension afin de libérer des ressources. Vous devez gérer l’événement Suspending pour enregistrer l’état de votre application en cas d’arrêt, et remplacer la méthode OnLaunched pour restaurer l’état de votre application. Vous devez gérer l’événement Reprise uniquement si vous avez besoin d’actualiser tout contenu affiché qui peut avoir changé pendant la suspension de l’application. Vous n’avez pas besoin de restaurer l’état d’une autre application lorsque l’application reprend.

En raison de sa position dans le modèle d’application, le codegen et la séquence d’activation, l’application a certaines restrictions sur son utilisation du code XAML :

À part les déclarations xmlns et x :Class, aucun autre attribut ne peut apparaître sur la Application balise racine.
N’essayez pas de modifier les valeurs x :Class qui proviennent des pages App.xaml du modèle de projet. Il existe des dépendances supplémentaires sur l’utilisation de ce schéma de nommage qui existent dans les actions de génération.
Ne pas relier les gestionnaires d’événements d’application en XAML. Tout le câblage d’événements doit être effectué dans le code (généralement dans le constructeur). En outre, vous utilisez généralement des substitutions de méthode plutôt que la syntaxe d’événement pour un événement (par exemple, vous remplacez OnActivated pour répondre à cette phase du cycle de vie de l’application.)
Les seules propriétés attendues sur un instance Application en XAML sont l’ensemble d’éléments pour remplir la propriété Application.Resources, à l’aide d’une utilisation d’élément de propriété XAML. Pour plus d’informations, consultez Ressources. Pour fournir une gestion générale des erreurs pour toutes les exceptions que votre code d’application n’intercepte pas, gérez l’événement UnhandledException .

Notes

Le fichier application main doit être nommé App.xaml.

Historique des versions

Version de Windows	Version du SDK	Valeur ajoutée
1607	14393	EnteredBackground
1607	14393	FocusVisualKind
1607	14393	LeavingBackground
1607	14393	OnBackgroundActivated
1607	14393	RequiresPointerMode
1703	15063	HighContrastAdjustment

Constructeurs

Application()

Initialise une nouvelle instance de la classe Application.

Propriétés

Current	Obtient l’objet Application pour l’application actuelle.
DebugSettings	Obtient un objet qui déclare le comportement de l’application lors de l’exécution dans un environnement de débogage.
FocusVisualKind	Obtient ou définit le type de commentaires visuels qu’une application peut utiliser pour indiquer l’élément d’interface utilisateur avec le focus. Cette propriété est valide uniquement pour les périphériques d’entrée qui peuvent générer des événements de touches, tels qu’un clavier ou un pavé de jeu.
HighContrastAdjustment	Obtient ou définit une valeur qui indique si l’infrastructure ajuste automatiquement les propriétés visuelles lorsque les thèmes à contraste élevé sont activés.
RequestedTheme	Obtient ou définit une valeur qui détermine la préférence clair-foncé pour le thème global d’une application.
RequiresPointerMode	Obtient ou définit si une application UWP prend en charge le mode souris, qui émule les expériences d’interaction de pointeur avec des périphériques d’entrée sans pointeur, tels qu’un pavé de jeu ou un contrôle à distance. (Tous les éléments imbriqués héritent de ce comportement.)
Resources	Obtient une collection de ressources étendues à l’application, telles que les styles, les modèles et les pinceaux.

Méthodes

Exit()	Arrête l’application.
LoadComponent(Object, Uri)	Charge un fichier XAML situé à l’emplacement relatif spécifié et le convertit en instance de l’objet spécifié par l’élément racine du fichier XAML.
LoadComponent(Object, Uri, ComponentResourceLocation)	Charge un fichier XAML situé à l’emplacement relatif spécifié et le convertit en instance de l’objet spécifié par l’élément racine du fichier XAML.
OnActivated(IActivatedEventArgs)	Appelé lorsque l’application est activée par d’autres moyens que le lancement normal.
OnBackgroundActivated(BackgroundActivatedEventArgs)	Appelé lorsque l’application est activée en arrière-plan.
OnCachedFileUpdaterActivated(CachedFileUpdaterActivatedEventArgs)	Appelé lorsque l’application est activée en raison d’un contrat d’activation avec ActivationKind en tant que CachedFileUpdater.
OnFileActivated(FileActivatedEventArgs)	Appelé lorsque l’application est activée via l’ouverture de fichier.
OnFileOpenPickerActivated(FileOpenPickerActivatedEventArgs)	Appelé lorsque l’application est activée par le biais d’une association de boîte de dialogue d’ouverture de fichier.
OnFileSavePickerActivated(FileSavePickerActivatedEventArgs)	Appelé lorsque l’application est activée par le biais d’une association de boîte de dialogue d’enregistrement de fichier.
OnLaunched(LaunchActivatedEventArgs)	Appelé au lancement de l’application. Remplacez cette méthode pour effectuer l’initialisation de l’application et afficher le contenu initial dans la fenêtre associée.
OnSearchActivated(SearchActivatedEventArgs)	Appelé lorsque l’application est activée par le biais d’une association de recherche.
OnShareTargetActivated(ShareTargetActivatedEventArgs)	Appelé lorsque l’application est activée par le biais d’une association de partage.
OnWindowCreated(WindowCreatedEventArgs)	Appelé lorsque l’application crée une fenêtre.
Start(ApplicationInitializationCallback)	Fournit le point d’entrée et les demandes d’initialisation de l’application. Utilisez le rappel pour instancier la classe Application .

Événements

EnteredBackground	Se produit lorsque l’application passe du premier plan à l’arrière-plan.
LeavingBackground	Se produit lorsque l’application passe de l’arrière-plan au premier plan.
Resuming	Se produit lorsque l’application passe de l’état Suspendu à l’état En cours d’exécution.
Suspending	Se produit lorsque l’application passe à l’état Suspendu à partir d’un autre état.
UnhandledException	Se produit lorsqu’une exception peut être gérée par le code d’application, comme transféré à partir d’une erreur de Windows Runtime native. Les applications peuvent marquer l’occurrence comme gérée dans les données d’événement.

S’applique à