Application Classe

Definição

Namespace:

Windows.UI.Xaml

Encapsula o aplicativo e seus serviços disponíveis.

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Application

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class Application

Public Class Application

<Application />
 

Herança

Object IInspectable Application

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Comentários

A classe Application encapsula um aplicativo e fornece os seguintes serviços:

• ponto de entrada do aplicativo, especialmente para vários contratos de ativação
• gerenciamento de tempo de vida do aplicativo
• recursos no escopo do aplicativo
• detecção de exceção sem tratamento

O objeto Application normalmente é fornecido no XAML inicial para App.xaml. Os modelos de projeto padrão no Visual Studio geram uma App classe derivada de Application e fornece um ponto de entrada em que você pode adicionar código de inicialização.

A App classe se associa ao XAML correspondente chamando o método gerado InitializeComponent em seu construtor. Você pode adicionar código de inicialização adicional ao App construtor, mas normalmente só adicionará código para associar manipuladores a eventos de aplicativo. Para outro código de inicialização, você deve substituir um ou mais métodos de inicialização, como OnLaunched.

O sistema lida com o tempo de vida do aplicativo suspendendo seu aplicativo sempre que o usuário alterna para outro aplicativo ou para a área de trabalho e retomando seu aplicativo sempre que o usuário alterna de volta para ele. No entanto, o sistema também pode encerrar seu aplicativo enquanto ele está suspenso para liberar recursos. Você deve manipular o evento Suspending para salvar o estado do aplicativo em caso de encerramento e substituir o método OnLaunched para restaurar o estado do aplicativo. Você deve manipular o evento Resuming somente se precisar atualizar qualquer conteúdo exibido que possa ter sido alterado enquanto o aplicativo está suspenso. Você não precisa restaurar outro estado do aplicativo quando o aplicativo é retomado.

Devido à sua posição no modelo de aplicativo, codegen e sequência de ativação, o Aplicativo tem algumas restrições sobre seu uso de XAML:

• Além das declarações xmlns e x:Class, nenhum outro atributo pode aparecer na Application marca raiz.
• Não tente alterar valores x:Class provenientes das páginas App.xaml do modelo de projeto, há dependências adicionais sobre o uso desse esquema de nomenclatura que existem nas ações de build.
• Não conecte os manipuladores de eventos de aplicativo em XAML. Toda a fiação de evento deve ser feita no código (geralmente no construtor). Além disso, geralmente você usa substituições de método em vez de sintaxe de evento para um evento (por exemplo, você substitui OnActivated para responder a essa fase do ciclo de vida do aplicativo).)
• As únicas propriedades esperadas em uma instância de Aplicativo em XAML é o conjunto de elementos para preencher a propriedade Application.Resources , usando um uso de elemento de propriedade XAML. Para obter mais informações, consulte Recursos. Para fornecer tratamento geral de erros para quaisquer exceções que o código do aplicativo não captura, manipule o evento UnhandledException .

Observação

O arquivo de main do aplicativo deve ser nomeado App.xamlcomo .

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
1607	14393	EnteredBackground
1607	14393	FocusVisualKind
1607	14393	LeavingBackground
1607	14393	OnBackgroundActivated
1607	14393	RequiresPointerMode
1703	15063	HighContrastAdjustment

Construtores

Application()

Inicializa uma nova instância da classe Application .

Propriedades

Current	Obtém o objeto Application para o aplicativo atual.
DebugSettings	Obtém um objeto que declara como o aplicativo se comporta quando executado em um ambiente de depuração.
FocusVisualKind	Obtém ou define o tipo de comentários visuais que um aplicativo pode usar para indicar o elemento de interface do usuário com foco. Essa propriedade é válida somente para dispositivos de entrada que podem gerar eventos importantes, como teclado ou teclado.
HighContrastAdjustment	Obtém ou define um valor que indica se a estrutura ajusta automaticamente as propriedades visuais quando os temas de alto contraste estão habilitados.
RequestedTheme	Obtém ou define um valor que determina a preferência claro-escuro para o tema geral de um aplicativo.
RequiresPointerMode	Obtém ou define se um aplicativo UWP dá suporte ao modo de mouse, o que emula experiências de interação de ponteiro com dispositivos de entrada sem ponteiro, como um painel de jogo ou controle remoto. (Todos os elementos aninhados herdam esse comportamento.)
Resources	Obtém uma coleção de recursos no escopo do aplicativo, como estilos, modelos e pincéis.

Métodos

Exit()	Desliga o aplicativo.
LoadComponent(Object, Uri)	Carrega um arquivo XAML localizado no local relativo especificado e o converte em uma instância do objeto especificada pelo elemento raiz do arquivo XAML.
LoadComponent(Object, Uri, ComponentResourceLocation)	Carrega um arquivo XAML localizado no local relativo especificado e o converte em uma instância do objeto especificada pelo elemento raiz do arquivo XAML.
OnActivated(IActivatedEventArgs)	Invocado quando o aplicativo é ativado por alguns meios diferentes da inicialização normal.
OnBackgroundActivated(BackgroundActivatedEventArgs)	Invocado quando o aplicativo é ativado em segundo plano.
OnCachedFileUpdaterActivated(CachedFileUpdaterActivatedEventArgs)	Invocado quando o aplicativo é ativado devido a um contrato de ativação com ActivationKind como CachedFileUpdater.
OnFileActivated(FileActivatedEventArgs)	Invocado quando o aplicativo é ativado por meio da abertura de arquivo.
OnFileOpenPickerActivated(FileOpenPickerActivatedEventArgs)	Invocado quando o aplicativo é ativado por meio da associação de caixa de diálogo de abertura de arquivo.
OnFileSavePickerActivated(FileSavePickerActivatedEventArgs)	Invocado quando o aplicativo é ativado por meio da associação de caixa de diálogo de salvamento de arquivo.
OnLaunched(LaunchActivatedEventArgs)	Invocado quando o aplicativo é iniciado. Substitua esse método para executar a inicialização do aplicativo e exibir o conteúdo inicial na Janela associada.
OnSearchActivated(SearchActivatedEventArgs)	Invocado quando o aplicativo é ativado por meio de uma associação de pesquisa.
OnShareTargetActivated(ShareTargetActivatedEventArgs)	Invocado quando o aplicativo é ativado por meio da associação de compartilhamento.
OnWindowCreated(WindowCreatedEventArgs)	Invocado quando o aplicativo cria uma janela.
Start(ApplicationInitializationCallback)	Fornece o ponto de entrada e solicita a inicialização do aplicativo. Use o retorno de chamada para instanciar a classe Application .

Eventos

EnteredBackground	Ocorre quando o aplicativo passa do primeiro plano para o segundo plano.
LeavingBackground	Ocorre quando o aplicativo passa da tela de fundo para o primeiro plano.
Resuming	Ocorre quando o aplicativo faz a transição do estado Suspenso para o estado Em execução.
Suspending	Ocorre quando o aplicativo faz a transição para o estado Suspenso de algum outro estado.
UnhandledException	Ocorre quando uma exceção pode ser tratada pelo código do aplicativo, conforme encaminhado de um erro de Windows Runtime de nível nativo. Os aplicativos podem marcar a ocorrência como tratada nos dados do evento.

Confira também

• Window
• Tratar a ativação do aplicativo
• Tratar a suspensão do aplicativo
• Tratar a retomada do app