Application Classe

Definição

Espaço de Nomes:
System.Windows
Assemblagem:
PresentationFramework.dll

Encapsula uma aplicação 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 seguinte mostra como uma aplicação padrão é definida usando apenas marcação:

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

O exemplo seguinte mostra como uma aplicação padrão é definida 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 seguinte mostra como uma aplicação padrão é definida 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

Observações

Application é uma classe que encapsula WPF funcionalidades específicas da aplicação, incluindo as seguintes:

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

Pode implementar um Application usando marcação, marcação e code-behind, ou código. Se o Application for implementado com marcação, seja marcação ou marcação e code-behind, o ficheiro de marcação deve ser configurado como um motor de construção Microsoft (MSBuild) ApplicationDefinition item.

Note

Uma aplicação autónoma 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, as aplicações de navegador XAML (XBAPs) requerem um Application objeto.

Construtores

Name Description
Application()

Inicializa uma nova instância da Application classe.

Propriedades

Name Description
Current

Obtém o Application objeto para a corrente AppDomain.
Dispatcher

Percebe o Dispatcher que isto DispatcherObject está associado.

(Herdado de DispatcherObject)
MainWindow

Obtém ou define a janela principal da aplicação.
Properties

Obtém um conjunto de propriedades de âmbito de aplicação.
ResourceAssembly

Obtém ou define o Assembly que fornece os identificadores uniformes de recursos (URIs) para os recursos numa aplicação WPF.
Resources

Obtém ou define uma coleção de recursos de âmbito de aplicação, como estilos e pincéis.
ShutdownMode

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

Recebe ou define uma interface que é automaticamente mostrada quando uma aplicação inicia.
Windows

Obtém as janelas instanciadas numa aplicação.

Métodos

Name Description
CheckAccess()

Determina se o thread que chama tem acesso a este DispatcherObject.

(Herdado de DispatcherObject)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
FindResource(Object)

Procura um recurso de interface de utilizador (UI), como um Style ou Brush, com a chave especificada, e lança uma exceção se o recurso solicitado não for encontrado (ver Recursos XAML).
GetContentStream(Uri)

Devolve um fluxo de recursos para um ficheiro de dados de conteúdo localizado no Uri especificado (ver WPF Application Resource, Content, and Data Files).
GetCookie(Uri)

Recupera um cookie para a localização especificada por um Uri.
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetRemoteStream(Uri)

Devolve um fluxo de recursos para um ficheiro de dados do local de origem localizado no Uri especificado (ver WPF Application Resource, Content, and Data Files).
GetResourceStream(Uri)

Devolve um fluxo de recursos para um ficheiro de dados de recurso localizado no Uri especificado (ver WPF Application Resource, Content, and Data Files).
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
LoadComponent(Object, Uri)

Carrega um ficheiro XAML localizado no identificador uniforme de recurso (URI) especificado e converte-o numa instância do objeto especificada pelo elemento raiz do ficheiro XAML.
LoadComponent(Uri)

Carrega um ficheiro XAML localizado no identificador uniforme de recurso (URI) especificado e converte-o numa instância do objeto especificada pelo elemento raiz do ficheiro XAML.
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
OnActivated(EventArgs)

Eleva o Activated evento.
OnDeactivated(EventArgs)

Eleva o Deactivated evento.
OnExit(ExitEventArgs)

Eleva o Exit evento.
OnFragmentNavigation(FragmentNavigationEventArgs)

Eleva o FragmentNavigation evento.
OnLoadCompleted(NavigationEventArgs)

Eleva o LoadCompleted evento.
OnNavigated(NavigationEventArgs)

Eleva o Navigated evento.
OnNavigating(NavigatingCancelEventArgs)

Eleva o Navigating evento.
OnNavigationFailed(NavigationFailedEventArgs)

Eleva o NavigationFailed evento.
OnNavigationProgress(NavigationProgressEventArgs)

Eleva o NavigationProgress evento.
OnNavigationStopped(NavigationEventArgs)

Eleva o NavigationStopped evento.
OnSessionEnding(SessionEndingCancelEventArgs)

Eleva o SessionEnding evento.
OnStartup(StartupEventArgs)

Eleva o Startup evento.
Run()

Inicia uma aplicação Windows Presentation Foundation.
Run(Window)

Inicia uma aplicação Windows Presentation Foundation e abre a janela especificada.
SetCookie(Uri, String)

Cria um cookie para a localização especificada por um Uri.
Shutdown()

Encerra uma aplicação.
Shutdown(Int32)

Desliga uma aplicação que devolve o código de saída especificado ao sistema operativo.
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)
TryFindResource(Object)

Pesquisa pelo recurso especificado.
VerifyAccess()

Faz cumprir que o thread que chama tem acesso a este DispatcherObject.

(Herdado de DispatcherObject)

evento

Name Description
Activated

Ocorre quando uma aplicação se torna a aplicação em primeiro plano.
Deactivated

Ocorre quando uma aplicação deixa de ser a aplicação em primeiro plano.
DispatcherUnhandledException

Ocorre quando uma exceção é lançada por uma aplicação mas não é tratada.
Exit

Ocorre pouco antes de uma candidatura encerrar e não pode ser cancelada.
FragmentNavigation

Ocorre quando um navegador na aplicação 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 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 navegado por um navegador na aplicação foi carregado, analisado e começou a ser renderizado.
Navigated

Ocorre quando o conteúdo que está a ser navegado por um navegador na aplicação foi encontrado, embora possa não ter terminado o carregamento.
Navigating

Ocorre quando uma nova navegação é solicitada por um navegador na aplicação.
NavigationFailed

Ocorre quando ocorre um erro enquanto um navegador na aplicação está a navegar para o conteúdo solicitado.
NavigationProgress

Ocorre periodicamente durante um download que está a ser gerido por um navegador na aplicação para fornecer informação sobre o progresso da navegação.
NavigationStopped

Ocorre quando o StopLoading método de um navegador na aplicação é chamado, ou quando uma nova navegação é solicitada por um navegador enquanto uma navegação atual está em curso.
SessionEnding

Ocorre quando o utilizador termina a sessão do Windows ao desligar ou desligar o sistema operativo.
Startup

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

Implementações de Interface Explícita

Name Description
IQueryAmbient.IsAmbientPropertyAvailable(String)

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

Aplica-se a

Segurança de Thread

Os membros públicos static (Shared em Visual Basic) deste tipo são seguros para threads. Além disso, os FindResource(Object) métodos e TryFindResource(Object) propriedades e PropertiesResources e são seguros para threads.

Ver também