Application Classe

Definição

Namespace:

Microsoft.UI.Xaml

Representa o aplicativo atual e seus serviços disponíveis.

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 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(Microsoft.UI.Xaml.WinUIContract), 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

Comentários

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

• ponto de entrada do aplicativo
• recursos no escopo do aplicativo
• detecção de exceção sem tratamento

O Application objeto normalmente é fornecido no XAML inicial para App.xaml. Os modelos de projeto padrão no Visual Studio geram uma App classe que deriva de e fornece um ponto de Application 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 um manipulador ao evento UnhandledException ou definir o RequestedTheme. Você deve colocar outro código de inicialização na substituição do método OnLaunched .

Dica

Para obter mais informações, consulte SDK do Aplicativo Windows ciclo de vida do aplicativo.

Devido à sua posição no modelo de aplicativo, codegen e sequência de ativação, Application tem algumas restrições em seu uso 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 Application manipuladores de eventos em XAML. Toda a fiação de evento deve ser feita no código (geralmente no construtor).
• As únicas propriedades esperadas em uma Application instância 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 Application arquivo main deve ser nomeado App.xaml.

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.
DispatcherShutdownMode	Obtém ou define um valor que especifica se o loop de eventos DispatcherQueue é encerrado quando todas as janelas XAML em um thread são fechadas.
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 que tem 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.
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.
OnLaunched(LaunchActivatedEventArgs)	Invocado quando o aplicativo é iniciado. Substitua esse método para executar a inicialização do aplicativo e criar uma nova janela.
Start(ApplicationInitializationCallback)	Fornece o ponto de entrada e solicita a inicialização do aplicativo. Use o ApplicationInitializationCallback especificado para instanciar a classe Application .

Eventos

ResourceManagerRequested	Ocorre durante a inicialização de um novo thread WinUI para permitir que você forneça uma implementação personalizada IResourceManager a ser usada pela estrutura para resolver URIs de recurso.
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
• SDK do Aplicativo Windows ciclo de vida do aplicativo