Partager via


AppInstance Classe

Définition

Représente une instance d’une application.

public ref class AppInstance sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 393216)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class AppInstance final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 393216)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class AppInstance
Public NotInheritable Class AppInstance
Héritage
Object Platform::Object IInspectable AppInstance
Attributs

Configuration requise pour Windows

Famille d’appareils
Windows 10, version 1803 (introduit dans 10.0.17134.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v6.0)

Remarques

Le système gère un magasin d’instances d’application. Les applications peuvent l’utiliser pour la redirection d’une application lorsqu’elle tente de s’activer.

Lorsqu’un processus d’application est créé dans la Main méthode de l’application, elle peut choisir de continuer à activer l’instance actuelle ou de rediriger l’activation vers une instance existante.

L’interpréteur de commandes peut fournir une instance préférée pour la redirection. L’application est encouragée à rediriger vers cette instance. Le choix de la redirection reste dans l’application.

La classe AppInstance est destinée à être utilisée dans la Main méthode de l’application. Si cette classe est utilisée ultérieurement, les valeurs de propriété peuvent être null, et les méthodes peuvent échouer.

Avant de pouvoir retourner des instances, elles doivent être inscrites auprès de FindOrRegisterInstanceForKey.

Cette classe ne peut être utilisée qu’à partir d’une application qui a choisi la multi-instanciation. Spécifiez l’attribut SupportsMultipleInstances sur l’élément Application dans le manifeste du package de l’application.

Propriétés

IsCurrentInstance

Indique si l’instance actuelle de l’application est l’instance inscrite de l’application pour la clé spécifique définie par cette instance.

Key

Clé de l’instance actuelle.

RecommendedInstance

Un interpréteur de commandes peut recommander une instance d’une application vers laquelle une activation d’application est redirigée.

Méthodes

FindOrRegisterInstanceForKey(String)

Inscrit une instance d’application auprès de la plateforme ou recherche une instance existante si une autre instance a déjà inscrit cette clé.

GetActivatedEventArgs()

Obtient le IActivatedEventArgs actuel, le même qui serait normalement passé à la méthode OnActivated de l’application.

GetInstances()

Obtient les instances inscrites de l’application actuelle.

RedirectActivationTo()

Redirige l’activation de l’instance d’application actuelle vers l’instance spécifiée.

Unregister()

Mises à jour le cache système afin que l’instance actuelle ne soit plus disponible pour la redirection d’activation.

S’applique à

Voir aussi