Condividi tramite


AppInstance Classe

Definizione

Rappresenta un'istanza di un'app.

public ref class AppInstance sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 393216)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class AppInstance final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 393216)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class AppInstance
Public NotInheritable Class AppInstance
Ereditarietà
Object Platform::Object IInspectable AppInstance
Attributi

Requisiti Windows

Famiglia di dispositivi
Windows 10, version 1803 (è stato introdotto in 10.0.17134.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v6.0)

Commenti

Il sistema gestisce un archivio di istanze dell'app. Le app possono usarlo per il reindirizzamento di un'app quando tenta di attivare.

Quando un processo dell'app viene creato nel Main metodo dell'app, può scegliere di continuare ad attivare l'istanza corrente o di reindirizzare l'attivazione a un'istanza esistente.

La shell può fornire un'istanza preferita per il reindirizzamento. L'app è incoraggiata a reindirizzare a tale istanza. La scelta di se reindirizzare rimane con l'app.

La classe AppInstance deve essere usata nel Main metodo dell'app. Se questa classe viene usata in un secondo momento, i valori delle proprietà possono essere nulle i metodi potrebbero non riuscire.

Prima che tutte le istanze possano essere restituite, devono essere registrate con FindOrRegisterInstanceForKey.

Questa classe può essere usata solo da un'app che ha acconconsenso esplicito a più istanze. Specificare l'attributo SupportsMultipleInstances nell'elemento Application nel manifesto del pacchetto per l'app.

Proprietà

IsCurrentInstance

Indica se l'istanza corrente dell'app è l'istanza registrata dell'app per la chiave specifica definita da questa istanza.

Key

Chiave per l'istanza corrente.

RecommendedInstance

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

Metodi

FindOrRegisterInstanceForKey(String)

Registra un'istanza dell'app con la piattaforma oppure trova un'istanza esistente se un'altra istanza ha già registrato questa chiave.

GetActivatedEventArgs()

Ottiene l'oggetto IActivatedEventArgs corrente, lo stesso che normalmente verrebbe passato al metodo OnActivated dell'app.

GetInstances()

Ottiene le istanze registrate dell'app corrente.

RedirectActivationTo()

Reindirizza l'attivazione dell'istanza dell'app corrente all'istanza specificata.

Unregister()

Aggiornamenti cache di sistema in modo che l'istanza corrente non sia più disponibile per il reindirizzamento dell'attivazione.

Si applica a

Vedi anche