Application Classe
Definição
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
- 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 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:
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 |
| 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.