AppInstance.RecommendedInstance Propriedade

Definição

Namespace:

Windows.ApplicationModel

Um shell pode recomendar uma instância de um aplicativo para o qual uma ativação de aplicativo é redirecionada.

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

Valor da propriedade

AppInstance

A instância do aplicativo que o shell prefere usar para um aplicativo ou null se não houver preferência.

Exemplos

Este exemplo verifica se o shell recomenda uma instância usando o método SelectedKeyIncludesMyKey definido pelo aplicativo. Nesse caso, ele verifica se a instância é adequada e redireciona para uma instância adequada. Se o shell não tiver preferência, o aplicativo poderá procurar uma instância de aplicativo existente para redirecionar ou tentar se registrar como o destino.

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

Comentários

Se o shell fornecer uma preferência, o aplicativo poderá redirecionar a ativação para essa instância. O aplicativo pode ignorar a preferência.

Observação

Atualmente, o shell não define um valor não nulo para RecommendedInstance.