Application Classe

Definição

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
Application
Implementações

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

Application implementa o padrão singleton para fornecer acesso compartilhado aos seus 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 uma marcação Application usando, 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.

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, 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 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

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