AppInstance Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 AppInstancePublic NotInheritable Class AppInstance- Ereditarietà
- 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. |