Application Class

Definition

Encapsula um aplicativo do Windows Presentation Foundation.Encapsulates a Windows Presentation Foundation application.

public ref class Application : System::Windows::Threading::DispatcherObject, System::Windows::Markup::IQueryAmbient
public ref class Application : System::Windows::Threading::DispatcherObject
public class Application : System.Windows.Threading.DispatcherObject, System.Windows.Markup.IQueryAmbient
public class Application : System.Windows.Threading.DispatcherObject
type Application = class
    inherit DispatcherObject
    interface IQueryAmbient
type Application = class
    inherit DispatcherObject
Public Class Application
Inherits DispatcherObject
Implements IQueryAmbient
Public Class Application
Inherits DispatcherObject
Inheritance
Application
Implements

Examples

O exemplo a seguir mostra como um aplicativo padrão é definido usando apenas marcação:The following example shows how a standard application is defined using only markup:

<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:The following example shows how a standard application is defined using only code:

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.The following example shows how a standard application is defined using a combination of markup and 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

Remarks

Application é uma classe que encapsula WPFWPF funcionalidade específica do aplicativo, incluindo o seguinte:Application is a class that encapsulates WPFWPF application-specific functionality, including the following:

Application implementa o padrão singleton para fornecer acesso compartilhado aos seus serviços de janela, propriedade e escopo de recurso.Application implements the singleton pattern to provide shared access to its window, property, and resource scope services. Consequentemente, apenas uma instância da classe Application pode ser criada por AppDomain.Consequently, only one instance of the Application class can be created per AppDomain.

Você pode implementar um Application usando marcação, marcação e code-behind, ou código.You can implement an Application using markup, markup and code-behind, or code. Se Application for implementado com marcação, seja marcação ou marcação e code-behind, o arquivo de marcação deverá ser configurado como um item de ApplicationDefinition de MSBuild (Microsoft Build Engine)Microsoft build engine (MSBuild).If Application is implemented with markup, whether markup or markup and code-behind, the markup file must be configured as an MSBuild (Microsoft Build Engine)Microsoft build engine (MSBuild) ApplicationDefinition item.

Note

Um aplicativo autônomo não requer um objeto Application; é possível implementar umMain(método de ponto de entrada) personalizado static que abre uma janela sem criar uma instância de Application.A standalone application does not require an Application object; it is possible to implement a custom static entry point method (Main) that opens a window without creating an instance of Application. No entanto, XBAPs (aplicativos de navegador XAML)XAML browser applications (XBAPs) requer um objeto Application.However, XBAPs (aplicativos de navegador XAML)XAML browser applications (XBAPs) require an Application object.

Constructors

Application()

Inicia uma nova instância da classe Application.Initializes a new instance of the Application class.

Properties

Current

Obtém o objeto Application da AppDomain atual.Gets the Application object for the current AppDomain.

Dispatcher

Obtém o Dispatcher ao qual este DispatcherObject está associado.Gets the Dispatcher this DispatcherObject is associated with.

(Inherited from DispatcherObject)
MainWindow

Obtém ou define a janela principal do aplicativo.Gets or sets the main window of the application.

Properties

Obtém uma coleção de propriedades de escopo de aplicativo.Gets a collection of application-scope properties.

ResourceAssembly

Obtém ou define o Assembly que oferece os URIs (Uniform Resource Identifier) de pacote para recursos em um aplicativo WPFWPF.Gets or sets the Assembly that provides the pack uniform resource identifiers (URIs) for resources in a WPFWPF application.

Resources

Obtém ou define uma coleção de recursos de escopo de aplicativo, como estilos e pincéis.Gets or sets a collection of application-scope resources, such as styles and brushes.

ShutdownMode

Obtém ou define a condição que faz o método Shutdown() ser chamado.Gets or sets the condition that causes the Shutdown() method to be called.

StartupUri

Obtém ou define uma interface do usuário que é mostrada automaticamente quando um aplicativo é iniciado.Gets or sets a UI that is automatically shown when an application starts.

Windows

Obtém as janelas instanciadas em um aplicativo.Gets the instantiated windows in an application.

Methods

CheckAccess()

Determina se o thread de chamada tem acesso a este DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
FindResource(Object)

Pesquisa um recurso UI (interface do usuário)user interface (UI), como um Style ou Brush, com a chave especificada e gera uma exceção se o recurso solicitado não é encontrado (consulte Recursos XAML).Searches for a UI (interface do usuário)user interface (UI) resource, such as a Style or Brush, with the specified key, and throws an exception if the requested resource is not found (see XAML Resources).

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).Returns a resource stream for a content data file that is located at the specified Uri (see WPF Application Resource, Content, and Data Files).

GetCookie(Uri)

Recupera um cookie para o local especificado por um Uri.Retrieves a cookie for the location specified by a Uri.

GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Inherited from 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).Returns a resource stream for a site-of-origin data file that is located at the specified Uri (see WPF Application Resource, Content, and Data Files).

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).Returns a resource stream for a resource data file that is located at the specified Uri (see WPF Application Resource, Content, and Data Files).

GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Inherited from Object)
LoadComponent(Object, Uri)

Carrega um arquivo XAMLXAML que está localizado no URI (Uniform Resource Identifier) especificado e o converte em uma instância do objeto especificada pelo elemento raiz do arquivo XAMLXAML.Loads a XAMLXAML file that is located at the specified uniform resource identifier (URI) and converts it to an instance of the object that is specified by the root element of the XAMLXAML file.

LoadComponent(Uri)

Carrega um arquivo XAMLXAML que está localizado no URI (Uniform Resource Identifier) especificado e o converte em uma instância do objeto especificada pelo elemento raiz do arquivo XAMLXAML.Loads a XAMLXAML file that is located at the specified uniform resource identifier (URI), and converts it to an instance of the object that is specified by the root element of the XAMLXAML file.

MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Inherited from Object)
OnActivated(EventArgs)

Gera o evento Activated.Raises the Activated event.

OnDeactivated(EventArgs)

Gera o evento Deactivated.Raises the Deactivated event.

OnExit(ExitEventArgs)

Gera o evento Exit.Raises the Exit event.

OnFragmentNavigation(FragmentNavigationEventArgs)

Gera o evento FragmentNavigation.Raises the FragmentNavigation event.

OnLoadCompleted(NavigationEventArgs)

Gera o evento LoadCompleted.Raises the LoadCompleted event.

OnNavigated(NavigationEventArgs)

Gera o evento Navigated.Raises the Navigated event.

OnNavigating(NavigatingCancelEventArgs)

Gera o evento Navigating.Raises the Navigating event.

OnNavigationFailed(NavigationFailedEventArgs)

Gera o evento NavigationFailed.Raises the NavigationFailed event.

OnNavigationProgress(NavigationProgressEventArgs)

Gera o evento NavigationProgress.Raises the NavigationProgress event.

OnNavigationStopped(NavigationEventArgs)

Gera o evento NavigationStopped.Raises the NavigationStopped event.

OnSessionEnding(SessionEndingCancelEventArgs)

Gera o evento SessionEnding.Raises the SessionEnding event.

OnStartup(StartupEventArgs)

Gera o evento Startup.Raises the Startup event.

Run()

Inicia um aplicativo do Windows Presentation Foundation.Starts a Windows Presentation Foundation application.

Run(Window)

Inicia um aplicativo do Windows Presentation Foundation e abre a janela especificada.Starts a Windows Presentation Foundation application and opens the specified window.

SetCookie(Uri, String)

Cria um cookie para o local especificado por um Uri.Creates a cookie for the location specified by a Uri.

Shutdown()

Desliga um aplicativo.Shuts down an application.

Shutdown(Int32)

Desliga um aplicativo que retorna o código de saída especificado para o sistema operacional.Shuts down an application that returns the specified exit code to the operating system.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Inherited from Object)
TryFindResource(Object)

Pesquisa o recurso especificado.Searches for the specified resource.

VerifyAccess()

Impõe que o thread de chamada tenha acesso a este DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)

Events

Activated

Ocorre quando um aplicativo se torna o aplicativo de primeiro plano.Occurs when an application becomes the foreground application.

Deactivated

Ocorre quando um aplicativo deixa de ser o aplicativo em primeiro plano.Occurs when an application stops being the foreground application.

DispatcherUnhandledException

Ocorre quando uma exceção é gerada por um aplicativo, mas não tratada.Occurs when an exception is thrown by an application but not handled.

Exit

Ocorre imediatamente antes de um aplicativo ser desligado e não pode ser cancelado.Occurs just before an application shuts down, and cannot be canceled.

FragmentNavigation

Ocorre quando um navegador no aplicativo inicia a navegação para um fragmento de conteúdo começar, a navegação ocorre imediatamente caso o fragmento desejado esteja no conteúdo atual ou depois se o conteúdo XAMLXAML da fonte ser carregado se o fragmento desejado estiver em outro conteúdo.Occurs when a navigator in the application begins navigation to a content fragment, Navigation occurs immediately if the desired fragment is in the current content, or after the source XAMLXAML content has been loaded if the desired fragment is in different content.

LoadCompleted

Ocorre quando o conteúdo que foi acessado por um navegador no aplicativo foi carregado, analisado e começou a ser renderizado.Occurs when content that was navigated to by a navigator in the application has been loaded, parsed, and has begun rendering.

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.Occurs when the content that is being navigated to by a navigator in the application has been found, although it may not have completed loading.

Navigating

Ocorre quando uma nova navegação é solicitada por um navegador no aplicativo.Occurs when a new navigation is requested by a navigator in the application.

NavigationFailed

Ocorre quando acontece um erro enquanto um navegador no aplicativo está navegando para o conteúdo solicitado.Occurs when an error occurs while a navigator in the application is navigating to the requested content.

NavigationProgress

Ocorre periodicamente durante um download que está sendo gerenciado por um navegador no aplicativo para fornecer informações de andamento de navegação.Occurs periodically during a download that is being managed by a navigator in the application to provide navigation progress information.

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.Occurs when the StopLoading method of a navigator in the application is called, or when a new navigation is requested by a navigator while a current navigation is in progress.

SessionEnding

Ocorre quando o usuário encerra a sessão do Windows fazendo logoff ou desligando o sistema operacional.Occurs when the user ends the Windows session by logging off or shutting down the operating system.

Startup

Ocorre quando o método Run() do objeto Application é chamado.Occurs when the Run() method of the Application object is called.

Explicit Interface Implementations

IQueryAmbient.IsAmbientPropertyAvailable(String)

Consulta se uma propriedade de ambiente especificada está disponível no escopo atual.Queries for whether a specified ambient property is available in the current scope.

Applies to

Thread Safety

Os membros do static público (Shared em Visual Basic) desse tipo são thread-safe.The public static (Shared in Visual Basic) members of this type are thread safe. Além disso, os métodos FindResource(Object) e TryFindResource(Object) e as propriedades Properties e Resources são thread-safe.In addition, the FindResource(Object) and TryFindResource(Object) methods and the Properties and Resources properties are thread safe.

See also