AppInstance.RecommendedInstance Eigenschaft

Definition

Namespace:

Windows.ApplicationModel

Eine Shell kann eine instance einer App empfehlen, an die eine Anwendungsaktivierung umgeleitet wird.

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

Eigenschaftswert

AppInstance

Die App instance, die die Shell lieber für eine App verwendet, oder null wenn keine Einstellung vorhanden ist.

Beispiele

In diesem Beispiel wird mithilfe der app-definierten SelectedKeyIncludesMyKey-Methode überprüft, ob die Shell eine instance empfiehlt. Wenn ja, überprüft es, ob die instance geeignet ist, und leitet zu einem geeigneten instance um. Wenn die Shell keine Einstellung hat, kann die App nach einer vorhandenen App suchen, die instance umgeleitet werden soll, oder versucht, sich selbst als Ziel zu registrieren.

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

Hinweise

Wenn die Shell eine Einstellung bereitstellt, kann die App die Aktivierung an diese instance umleiten. Die App kann die Einstellung ignorieren.

Hinweis

Derzeit legt die Shell keinen Wert ungleich NULL für RecommendedInstance fest.