AppInstance Classe

  • Referência

Definição

Namespace:
Windows.ApplicationModel
Editar

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 AppInstance
Public NotInheritable Class AppInstance
Herança
Object Platform::Object IInspectable AppInstance
Atributos
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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.

Aplica-se a

Confira também