Application Classe

Definição

Namespace:
System.Windows
Assembly:
PresentationFramework.dll

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:

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

O exemplo a seguir mostra como um aplicativo padrão é definido usando apenas o 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.

<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 WPF funcionalidade específica do aplicativo, incluindo o seguinte:

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

Você pode implementar uma marcação 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 Microsoft mecanismo de build (MSBuild) ApplicationDefinition item.

Note

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 de Application. No entanto, os XBAPs (aplicativos do navegador XAML) exigem um Application objeto.

Construtores

Nome Description
Application()

Inicializa uma nova instância da classe Application.

Propriedades

Nome Description
Current

Obtém o Application objeto para o atual AppDomain.
Dispatcher

Obtém o Dispatcher que 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 (identificadores de recursos) uniformes do pacote para recursos em um aplicativo WPF.
Resources

Obtém ou define uma coleção de recursos de escopo do aplicativo, como estilos e pincéis.
ShutdownMode

Obtém ou define a condição que faz com que o Shutdown() método seja chamado.
StartupUri

Obtém ou define uma interface do usuário que é mostrada automaticamente quando um aplicativo é iniciado.
Windows

Obtém as janelas instanciadas em um aplicativo.

Métodos

Nome Description
CheckAccess()

Determina se o thread de chamada tem acesso a isso 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 WPF Application Resource, Content e Data Files).
GetCookie(Uri)

Recupera um cookie para o local especificado por um Uri.
GetHashCode()

Serve como a função hash predefinida.

(Herdado de Object)
GetRemoteStream(Uri)

Retorna um fluxo de recursos para um arquivo de dados do site de origem localizado no Uri especificado (consulte WPF Application Resource, Content e Data Files).
GetResourceStream(Uri)

Retorna um fluxo de recursos para um arquivo de dados de recurso localizado no Uri especificado (consulte WPF Application Resource, Content e Data Files).
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
LoadComponent(Object, Uri)

Carrega um arquivo XAML que está 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 que está 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 Objectatual.

(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 isso DispatcherObject.

(Herdado de DispatcherObject)

Eventos

Nome Description
Activated

Ocorre quando um aplicativo se torna o aplicativo em 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, a navegação ocorre imediatamente se o fragmento desejado estiver no conteúdo atual ou depois que o conteúdo XAML de origem tiver sido carregado se o fragmento desejado estiver em conteúdo diferente.
LoadCompleted

Ocorre quando o conteúdo que foi navegado por um navegador no aplicativo foi carregado, analisado e iniciado a renderização.
Navigated

Ocorre quando o conteúdo que está sendo navegado por um navegador no aplicativo foi encontrado, embora possa não ter concluído o carregamento.
Navigating

Ocorre quando uma nova navegação é solicitada por um navegador no aplicativo.
NavigationFailed

Ocorre quando ocorre 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 progresso de navegação.
NavigationStopped

Ocorre quando o StopLoading método 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 termina a sessão Windows fazendo logon ou desligando o sistema operacional.
Startup

Ocorre quando o Run() método do Application objeto é chamado.

Implantações explícitas de interface

Nome Description
IQueryAmbient.IsAmbientPropertyAvailable(String)

Consultas para saber se uma propriedade ambiente especificada está disponível no escopo atual.

Aplica-se a

Acesso thread-safe

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

Confira também