Application Classe

Referência

Definição

Namespace:: System.Windows

Assembly:: PresentationFramework.dll

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 um aplicativo do Windows Presentation Foundation.

public ref class Application : System::Windows::Threading::DispatcherObject

public ref class Application : System::Windows::Threading::DispatcherObject, System::Windows::Markup::IQueryAmbient

public class Application : System.Windows.Threading.DispatcherObject

public class Application : System.Windows.Threading.DispatcherObject, System.Windows.Markup.IQueryAmbient

type Application = class
    inherit DispatcherObject

type Application = class
    inherit DispatcherObject
    interface IQueryAmbient

Public Class Application
Inherits DispatcherObject

Public Class Application
Inherits DispatcherObject
Implements IQueryAmbient

Herança: Object

DispatcherObject
Application

Implementações: IQueryAmbient

Exemplos

O exemplo a seguir mostra como um aplicativo padrão é definido usando apenas marcação:

XAML

<Application xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" />

O exemplo a seguir mostra como um aplicativo padrão é definido usando apenas código:

using System;
using System.Windows;

namespace SDKSample
{
    public class AppCode : Application
    {
        // Entry point method
        [STAThread]
        public static void Main()
        {
            AppCode app = new AppCode();
            app.Run();
        }
    }
}


Imports System.Windows

Namespace SDKSample
    Public Class AppCode
        Inherits Application
        ' Entry point method
        <STAThread>
        Public Shared Sub Main()
            Dim app As New AppCode()
            app.Run()
        End Sub
    End Class
End Namespace

O exemplo a seguir mostra como um aplicativo padrão é definido usando uma combinação de marcação e code-behind.

XAML

<Application 
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
  x:Class="SDKSample.App" />

using System.Windows;

namespace SDKSample
{
    public partial class App : Application { }
}


Imports System.Windows

Namespace SDKSample
    Partial Public Class App
        Inherits Application
    End Class
End Namespace

Comentários

Application é uma classe que encapsula a funcionalidade específica do aplicativo WPF, incluindo o seguinte:

Tempo de vida do aplicativo: Activated, Current, Deactivated, DispatcherUnhandledException, Exit, Run, SessionEnding, Shutdown, ShutdownMode, Startup.
Janela de escopo do aplicativo, propriedade e gerenciamento de recursos: FindResource, GetContentStream, GetResourceStream, LoadComponent, MainWindow, Properties, Resources, StartupUri, . Windows
Parâmetro de linha de comando e processamento de código de saída: Application.Startup, Application.Exit, Application.Shutdown.
Navegação: FragmentNavigation, LoadCompleted, Navigated, Navigating, NavigationProgress, NavigationStopped, NavigationFailed, SetCookie, . GetCookie

Application implementa o padrão singleton para fornecer acesso compartilhado aos serviços de janela, propriedade e escopo de recursos. Consequentemente, apenas uma instância da Application classe pode ser criada por AppDomain.

Você pode implementar um Application usando marcação, marcação e code-behind ou código. Se Application for implementado com marcação, marcação ou marcação e code-behind, o arquivo de marcação deverá ser configurado como um item do MSBuild (mecanismo de build da ApplicationDefinition Microsoft).

Observação

Um aplicativo autônomo não requer um Application objeto ; é possível implementar um método de ponto de entrada personalizado static (Main) que abre uma janela sem criar uma instância do Application. No entanto, os XBAPs (aplicativos do navegador XAML) exigem um Application objeto .

Construtores

Application()

Inicializa uma nova instância da classe Application.

Propriedades

Current	Obtém o objeto Application da AppDomain atual.
Dispatcher	Obtém o Dispatcher ao qual este DispatcherObject está associado. (Herdado de DispatcherObject)
MainWindow	Obtém ou define a janela principal do aplicativo.
Properties	Obtém uma coleção de propriedades de escopo de aplicativo.
ResourceAssembly	Obtém ou define o Assembly que fornece os URIs (uniform resource identifiers) do pacote para recursos em um aplicativo WPF.
Resources	Obtém ou define uma coleção de recursos de escopo de aplicativo, como estilos e pincéis.
ShutdownMode	Obtém ou define a condição que faz o método Shutdown() ser chamado.
StartupUri	Obtém ou define uma interface do usuário que é mostrada automaticamente quando um aplicativo é iniciado.
ThemeMode	Encapsula um aplicativo do Windows Presentation Foundation.
Windows	Obtém as janelas instanciadas em um aplicativo.

Métodos

CheckAccess()	Determina se o thread de chamada tem acesso a este DispatcherObject. (Herdado de DispatcherObject)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
FindResource(Object)	Pesquisa um recurso de interface do usuário, como um Style ou Brush, com a chave especificada e gera uma exceção se o recurso solicitado não for encontrado (consulte Recursos XAML).
GetContentStream(Uri)	Retorna um fluxo de recursos para um arquivo de dados de conteúdo localizado no Uri especificado (consulte Recurso de aplicativo do WPF, conteúdo e arquivos de dados).
GetCookie(Uri)	Recupera um cookie para o local especificado por um Uri.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetRemoteStream(Uri)	Retorna um fluxo de recursos para um arquivo de dados do site de origem localizado no Uri especificado (consulte Arquivos de recurso, conteúdo e dados do aplicativo WPF).
GetResourceStream(Uri)	Retorna um fluxo de recursos para um arquivo de dados de recurso localizado no Uri especificado (consulte Arquivos de recurso, conteúdo e dados do aplicativo WPF).
GetType()	Obtém o Type da instância atual. (Herdado de Object)
LoadComponent(Object, Uri)	Carrega um arquivo XAML localizado no URI (uniform resource identifier) especificado e o converte em uma instância do objeto especificada pelo elemento raiz do arquivo XAML.
LoadComponent(Uri)	Carrega um arquivo XAML localizado no URI (uniform resource identifier) especificado e o converte em uma instância do objeto especificada pelo elemento raiz do arquivo XAML.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
OnActivated(EventArgs)	Aciona o evento Activated.
OnDeactivated(EventArgs)	Aciona o evento Deactivated.
OnExit(ExitEventArgs)	Aciona o evento Exit.
OnFragmentNavigation(FragmentNavigationEventArgs)	Aciona o evento FragmentNavigation.
OnLoadCompleted(NavigationEventArgs)	Aciona o evento LoadCompleted.
OnNavigated(NavigationEventArgs)	Aciona o evento Navigated.
OnNavigating(NavigatingCancelEventArgs)	Aciona o evento Navigating.
OnNavigationFailed(NavigationFailedEventArgs)	Aciona o evento NavigationFailed.
OnNavigationProgress(NavigationProgressEventArgs)	Aciona o evento NavigationProgress.
OnNavigationStopped(NavigationEventArgs)	Aciona o evento NavigationStopped.
OnSessionEnding(SessionEndingCancelEventArgs)	Aciona o evento SessionEnding.
OnStartup(StartupEventArgs)	Aciona o evento Startup.
Run()	Inicia um aplicativo do Windows Presentation Foundation.
Run(Window)	Inicia um aplicativo do Windows Presentation Foundation e abre a janela especificada.
SetCookie(Uri, String)	Cria um cookie para o local especificado por um Uri.
Shutdown()	Desliga um aplicativo.
Shutdown(Int32)	Desliga um aplicativo que retorna o código de saída especificado para o sistema operacional.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
TryFindResource(Object)	Pesquisa o recurso especificado.
VerifyAccess()	Impõe que o thread de chamada tenha acesso a este DispatcherObject. (Herdado de DispatcherObject)

Eventos

Activated	Ocorre quando um aplicativo se torna o aplicativo de primeiro plano.
Deactivated	Ocorre quando um aplicativo deixa de ser o aplicativo em primeiro plano.
DispatcherUnhandledException	Ocorre quando uma exceção é gerada por um aplicativo, mas não tratada.
Exit	Ocorre logo antes de um aplicativo ser desligado e não pode ser cancelado.
FragmentNavigation	Ocorre quando um navegador no aplicativo inicia a navegação para um fragmento de conteúdo, Navegação ocorre imediatamente se o fragmento desejado está no conteúdo atual ou após o conteúdo XAML de origem ter sido carregado se o fragmento desejado estiver em conteúdo diferente.
LoadCompleted	Ocorre quando o conteúdo que foi acessado por um navegador no aplicativo foi carregado, analisado e começou a ser renderizado.
Navigated	Ocorre quando o conteúdo para o qual se está navegando por um navegador no aplicativo foi encontrado, embora ele talvez não tenha concluído o carregamento.
Navigating	Ocorre quando uma nova navegação é solicitada por um navegador no aplicativo.
NavigationFailed	Ocorre quando acontece um erro enquanto um navegador no aplicativo está navegando para o conteúdo solicitado.
NavigationProgress	Ocorre periodicamente durante um download que está sendo gerenciado por um navegador no aplicativo para fornecer informações de andamento de navegação.
NavigationStopped	Ocorre quando o método `StopLoading` de um navegador no aplicativo é chamado ou quando uma nova navegação é solicitada por um navegador enquanto uma navegação atual está em andamento.
SessionEnding	Ocorre quando o usuário encerra a sessão do Windows fazendo logoff ou desligando o sistema operacional.
Startup	Ocorre quando o método Run() do objeto Application é chamado.

Implantações explícitas de interface

IQueryAmbient.IsAmbientPropertyAvailable(String)

Consulta se uma propriedade de ambiente especificada está disponível no escopo atual.

Aplica-se a

Produto	Versões
.NET Framework	3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

Acesso thread-safe

Os membros públicos static (Shared no Visual Basic) desse tipo são thread-safe. Além disso, os FindResource(Object) métodos e TryFindResource(Object) e as Properties propriedades e Resources são thread-safe.

Confira também

Window

Compartilhar via