AppInstance.RecommendedInstance プロパティ

定義

名前空間:

Windows.ApplicationModel

シェルは、アプリケーションのアクティブ化がリダイレクトされるアプリのインスタンスを推奨できます。

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

プロパティ値

AppInstance

シェルがアプリに使用するアプリ インスタンス。または null 優先設定がない場合は 。

例

この例では、アプリ定義 の SelectedKeyIncludesMyKey メソッドを使用して、シェルがインスタンスを推奨するかどうかを確認します。 その場合は、インスタンスが適切かどうかを確認し、適切なインスタンスにリダイレクトします。 シェルに優先設定がない場合、アプリはリダイレクト先の既存のアプリ インスタンスを探すか、ターゲットとして自身を登録しようとします。

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

注釈

シェルが優先設定を提供する場合、アプリはそのインスタンスにアクティブ化をリダイレクトできます。 アプリは設定を無視できます。

Note

現在、シェルは RecommendedInstance に null 以外の値を設定していません。