Partage via


Application Classe

Définition

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

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, 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.

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.

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 à

Voir aussi