AppInstance.RedirectActivationTo Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Leitet die Aktivierung der aktuellen App-instance an die angegebene instance um.
public:
virtual void RedirectActivationTo() = RedirectActivationTo;
void RedirectActivationTo();
public void RedirectActivationTo();
function redirectActivationTo()
Public Sub RedirectActivationTo ()
Beispiele
In diesem Beispiel wird die Aktivierung an die von der Shell empfohlene instance umgeleitet. Im Beispiel wird zunächst überprüft, ob eine empfohlene instance vorhanden ist und ob sie geeignet ist. Wenn die Shell keine Präferenz hat, kann die App nach einer vorhandenen App suchen instance, an die 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
Die Umleitung ist ein Terminalvorgang. Nach der Umleitung kann die App nur CoreApplication.Exit aufrufen. Nach der Umleitung wird die App geschlossen.
Eine App gibt an, ob sie mehrere Instanzen in ihrem Manifest unterstützt. Der Begrüßungsbildschirm wird erst angezeigt, wenn die App entscheidet, ob sie während der Standard umgeleitet werden soll. Wenn die App nicht innerhalb eines Timeoutzeitraums entscheidet, wird sie geschlossen.
Es gibt eine potenzielle Racebedingung, wenn eine App einen instance für die Umleitung identifiziert, aber diese instance stirbt, bevor sie aktiviert werden kann. In diesem Fall schlägt diese Aktivierung fehl.