Application 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.
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 ApplicationPublic Class Application<Application />
- Herança
- Atributos
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
Applicationmarca 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.
|
| 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, 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. |
| 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. |
| 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. |