Application Classe

Définition

Espace de noms:

Microsoft.UI.Xaml

Représente l’application actuelle et ses services disponibles.

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 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(Microsoft.UI.Xaml.WinUIContract), 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

Remarques

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

• point d’entrée de l’application
• 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 de 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 un gestionnaire à l’événement UnhandledException ou définir le RequestedTheme. Vous devez placer un autre code d’initialisation dans le remplacement de méthode OnLaunched .

Conseil

Pour plus d’informations, consultez SDK d'application Windows cycle de vie de l’application.

En raison de sa position dans le modèle d’application, codegen et la séquence d’activation, Application a certaines restrictions sur son utilisation 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 Application gestionnaires d’événements en XAML. Tout le câblage d’événements doit être effectué dans le code (généralement dans le constructeur).
• Les seules propriétés attendues sur un Application instance 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 Application fichier main doit être nommé App.xaml.

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.
DispatcherShutdownMode	Obtient ou définit une valeur qui spécifie si la boucle d’événement DispatcherQueue se ferme lorsque toutes les fenêtres XAML d’un thread sont fermées.
FocusVisualKind	Obtient ou définit le type de commentaires visuels qu’une application peut utiliser pour indiquer l’élément d’interface utilisateur qui a le focus.
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.
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.
OnLaunched(LaunchActivatedEventArgs)	Appelé au lancement de l’application. Remplacez cette méthode pour effectuer l’initialisation de l’application et créer une fenêtre.
Start(ApplicationInitializationCallback)	Fournit le point d’entrée et les demandes d’initialisation de l’application. Utilisez l’applicationInitializationCallback spécifiée pour instancier la classe Application .

Événements

ResourceManagerRequested	Se produit lors du démarrage d’un nouveau thread WinUI pour vous permettre de fournir une implémentation personnalisée IResourceManager à utiliser par l’infrastructure pour résoudre les URI de ressources.
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.

Voir aussi

• Window
• SDK d'application Windows cycle de vie de l’application