AppInstance.RedirectActivationTo メソッド

定義

現在のアプリ インスタンスのアクティブ化を、指定したインスタンスにリダイレクトします。

public:
 virtual void RedirectActivationTo() = RedirectActivationTo;
void RedirectActivationTo();
public void RedirectActivationTo();
function redirectActivationTo()
Public Sub RedirectActivationTo ()

次の使用例は、シェルで推奨されるインスタンスにアクティブ化をリダイレクトします。 この例では、最初に、推奨されるインスタンスがあるかどうかと、それが適切かどうかを確認します。 シェルに優先設定がない場合、アプリはリダイレクト先の既存のアプリ インスタンスを検索するか、ターゲットとして自身を登録しようとします。

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

注釈

リダイレクトはターミナル操作です。 リダイレクト後、アプリは CoreApplication.Exit のみを呼び出すことができます。 リダイレクト後、アプリは閉じられます。

アプリは、マニフェストで複数のインスタンスをサポートするかどうかを示します。 スプラッシュ画面は、アプリがメイン中にリダイレクトするかどうかを決定するまで表示されません。 アプリがタイムアウト期間内に決定できない場合、アプリは閉じられます。

アプリがリダイレクトのインスタンスを識別したが、そのインスタンスがアクティブ化される前に終了すると、競合状態が発生する可能性があります。 この場合、このアクティブ化は失敗します。

適用対象

こちらもご覧ください