AppInstance Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Representa uma instância de um aplicativo.
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- Herança
- Atributos
Requisitos do Windows
| Família de dispositivos |
Windows 10, version 1803 (introduzida na 10.0.17134.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduzida na v6.0)
|
Comentários
O sistema mantém um repositório de instâncias de aplicativo. Os aplicativos podem usá-lo para redirecionamento de um aplicativo quando ele tenta ativar.
Quando um processo de aplicativo é criado no Main método do aplicativo, ele pode optar por continuar a ativar a instância atual ou redirecionar a ativação para uma instância existente.
O shell pode fornecer uma instância preferencial para redirecionamento. O aplicativo é incentivado a redirecionar para essa instância. A escolha de redirecionar permanece com o aplicativo.
A classe AppInstance destina-se a ser usada no Main método do aplicativo. Se essa classe for usada posteriormente, os valores de propriedade poderão ser nulle os métodos poderão falhar.
Antes que qualquer instância possa ser retornada, elas devem ser registradas com FindOrRegisterInstanceForKey.
Essa classe só pode ser usada de um aplicativo que tenha optado por fazer várias instanciação. Especifique o atributo SupportsMultipleInstances no elemento Application no manifesto do pacote para o aplicativo.
Propriedades
| IsCurrentInstance |
Se a instância atual do aplicativo é a instância registrada do aplicativo para a chave específica que essa instância definiu. |
| Key |
A chave para a instância atual. |
| RecommendedInstance |
Um shell pode recomendar uma instância de um aplicativo para o qual uma ativação de aplicativo é redirecionada. |
Métodos
| FindOrRegisterInstanceForKey(String) |
Registra uma instância de aplicativo com a plataforma ou localiza uma instância existente se outra instância já tiver registrado essa chave. |
| GetActivatedEventArgs() |
Obtém o IActivatedEventArgs atual, o mesmo que normalmente seria passado para o método OnActivated do aplicativo. |
| GetInstances() |
Obtém as instâncias registradas do aplicativo atual. |
| RedirectActivationTo() |
Redireciona a ativação da instância do aplicativo atual para a instância especificada. |
| Unregister() |
Atualizações o cache do sistema para que a instância atual não esteja mais disponível para redirecionamento de ativação. |