AppInstance.RecommendedInstance Propiedad

Definición

Espacio de nombres:

Windows.ApplicationModel

Un shell puede recomendar una instancia de una aplicación a la que se redirige una activación de aplicación.

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 de propiedad

AppInstance

Instancia de aplicación que el shell prefiere usar para una aplicación o null si no hay ninguna preferencia.

Ejemplos

En este ejemplo se comprueba si el shell recomienda una instancia mediante el método SelectedKeyIncludesMyKey definido por la aplicación. Si es así, comprueba si la instancia es adecuada y redirige a una instancia adecuada. Si el shell no tiene preferencia, la aplicación puede buscar una instancia de aplicación existente para redirigirla o intentar registrarse como 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.
}

Comentarios

Si el shell proporciona una preferencia, la aplicación puede redirigir la activación a esa instancia. La aplicación puede omitir la preferencia.

Nota:

Actualmente, el shell no establece un valor distinto de NULL para RecommendedInstance.