AppInstance.RecommendedInstance Propriété

Définition

Espace de noms:

Windows.ApplicationModel

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

public:
 static property AppInstance ^ RecommendedInstance { AppInstance ^ get(); };

static AppInstance RecommendedInstance();

public static AppInstance RecommendedInstance { get; }

var appInstance = AppInstance.recommendedInstance;

Public Shared ReadOnly Property RecommendedInstance As AppInstance

Valeur de propriété

AppInstance

L’application instance que l’interpréteur de commandes préfère utiliser pour une application, ou null s’il n’y a aucune préférence.

Exemples

Cet exemple montre comment vérifier si l’interpréteur de commandes recommande un instance à l’aide de la méthode SelectedKeyIncludesMyKey définie par l’application. Dans ce cas, il vérifie si le instance est approprié et redirige vers un instance approprié. Si l’interpréteur de commandes n’a pas de préférence, l’application peut rechercher une application existante instance à rediriger vers ou tenter de s’inscrire en tant que cible.

AppInstance RecommendedInstance = AppInstance.RecommendedInstance;
if ((RecommendedInstance != null) && SelectedKeyIncludesMyKey(RecommendedInstance.Key))
{
    RecommendedInstance.RedirectActivationTo();
}
else
{
    // Look for existing instance or attempt to register itself as target.
}

Remarques

Si l’interpréteur de commandes fournit une préférence, l’application peut rediriger l’activation vers cette instance. L’application peut ignorer la préférence.

Notes

Actuellement, l’interpréteur de commandes ne définit pas de valeur non null pour RecommendedInstance.