AppInstance.RedirectActivationTo Methode

Definition

Namespace:

Windows.ApplicationModel

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.

Weitere Informationen

• Exit()