AppInstance.RecommendedInstance Proprietà

Definizione

Spazio dei nomi:

Windows.ApplicationModel

Una shell può consigliare un'istanza di un'app a cui viene reindirizzata un'attivazione dell'applicazione.

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

Valore della proprietà

AppInstance

Istanza dell'app che la shell preferisce usare per un'app o null se non esiste alcuna preferenza.

Esempio

In questo esempio viene verificato se la shell consiglia un'istanza usando il metodo SelectedKeyIncludesMyKey definito dall'app. In tal caso, controlla se l'istanza è adatta e reindirizza a un'istanza appropriata. Se la shell non ha preferenze, l'app può cercare un'istanza dell'app esistente per reindirizzare o tentare di registrarsi come destinazione.

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

Commenti

Se la shell fornisce una preferenza, l'app può reindirizzare l'attivazione a tale istanza. L'app può ignorare la preferenza.

Nota

Attualmente, la shell non imposta un valore non Null per RecommendedInstance.