Application Application Application Application Class

Definición

Encapsula una aplicación para Windows Presentation Foundation.Encapsulates a Windows Presentation Foundation application.

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

Ejemplos

El ejemplo siguiente muestra cómo es una aplicación estándar define sólo mediante marcado:The following example shows how a standard application is defined using only markup:

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

El ejemplo siguiente se muestra cómo una aplicación estándar se define utilizando sólo 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 Microsoft.VisualBasic
Imports System
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

El ejemplo siguiente muestra cómo una aplicación estándar está definido mediante una combinación de marcado y código subyacente.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 Microsoft.VisualBasic
Imports System.Windows

Namespace SDKSample
	Partial Public Class App
		Inherits Application
	End Class
End Namespace

Comentarios

Application es una clase que encapsula WPFWPF funcionalidad específica de la aplicación, incluidos los siguientes:Application is a class that encapsulates WPFWPF application-specific functionality, including the following:

Application implementa el patrón singleton para proporcionar acceso compartido a su ventana, propiedad y servicios del ámbito de recursos.Application implements the singleton pattern to provide shared access to its window, property, and resource scope services. Por lo tanto, solo una instancia de la Application clase se puede crear por AppDomain.Consequently, only one instance of the Application class can be created per AppDomain.

Puede implementar un Application mediante marcado, marcado y código subyacente o código.You can implement an Application using markup, markup and code-behind, or code. Si Application se implementa con el marcado, si el marcado o marcado y código subyacente, el archivo de marcado debe estar configurado como un Microsoft build engine (MSBuild)Microsoft build engine (MSBuild) ApplicationDefinition elemento.If Application is implemented with markup, whether markup or markup and code-behind, the markup file must be configured as an Microsoft build engine (MSBuild)Microsoft build engine (MSBuild) ApplicationDefinition item.

Nota

Una aplicación independiente no requiere un Application objeto; es posible implementar un personalizado static método de punto de entrada (Main) que abre una ventana sin necesidad de crear una instancia 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. Sin embargo, Aplicaciones del explorador XAML (XBAPs)XAML browser applications (XBAPs) requieren un Application objeto.However, Aplicaciones del explorador XAML (XBAPs)XAML browser applications (XBAPs) require an Application object.

Constructores

Application() Application() Application() Application()

Inicializa una nueva instancia de la clase Application.Initializes a new instance of the Application class.

Propiedades

Current Current Current Current

Obtiene el objeto Application para el AppDomain actual.Gets the Application object for the current AppDomain.

Dispatcher Dispatcher Dispatcher Dispatcher

Obtiene el Dispatcher esto DispatcherObject está asociado.Gets the Dispatcher this DispatcherObject is associated with.

(Inherited from DispatcherObject)
MainWindow MainWindow MainWindow MainWindow

Obtiene o establece la ventana principal de la aplicación.Gets or sets the main window of the application.

Properties Properties Properties Properties

Obtiene una colección de las propiedades del ámbito de la aplicación.Gets a collection of application-scope properties.

ResourceAssembly ResourceAssembly ResourceAssembly ResourceAssembly

Obtiene o establece el objeto Assembly que proporciona los identificadores de recursos uniformes (URI)uniform resource identifiers (URIs) de paquete de los recursos de una aplicación de WPFWPF.Gets or sets the Assembly that provides the pack identificadores de recursos uniformes (URI)uniform resource identifiers (URIs) for resources in a WPFWPF application.

Resources Resources Resources Resources

Obtiene o establece una colección de recursos del ámbito de la aplicación, como estilos y pinceles.Gets or sets a collection of application-scope resources, such as styles and brushes.

ShutdownMode ShutdownMode ShutdownMode ShutdownMode

Obtiene o establece la condición que hace que se llame al método Shutdown().Gets or sets the condition that causes the Shutdown() method to be called.

StartupUri StartupUri StartupUri StartupUri

Obtiene o establece una IU que se muestra automáticamente al iniciar una aplicación.Gets or sets a UI that is automatically shown when an application starts.

Windows Windows Windows Windows

Obtiene las ventanas con instancias de una aplicación.Gets the instantiated windows in an application.

Métodos

CheckAccess() CheckAccess() CheckAccess() CheckAccess()

Determina si el subproceso de llamada tiene acceso a este DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
FindResource(Object) FindResource(Object) FindResource(Object) FindResource(Object)

Busca un recurso de interfaz de usuario (UI)user interface (UI), como Style o Brush, con la clave especificada, y produce una excepción si no se encuentra el recurso solicitado (vea XAML Resources).Searches for a interfaz de usuario (UI)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) GetContentStream(Uri) GetContentStream(Uri) GetContentStream(Uri)

Devuelve una secuencia de recursos para un archivo de datos de contenido ubicado en el Uri especificado. Vea WPF Application Resource, Content, and Data Files (Archivos de datos, contenido y recursos de aplicaciones para WPF).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) GetCookie(Uri) GetCookie(Uri) GetCookie(Uri)

Recupera una cookie para la ubicación especificada por Uri.Retrieves a cookie for the location specified by a Uri.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetRemoteStream(Uri) GetRemoteStream(Uri) GetRemoteStream(Uri) GetRemoteStream(Uri)

Devuelve una secuencia de recursos para un archivo de datos de sitio de origen ubicado en el Uri especificado. Vea WPF Application Resource, Content, and Data Files (Archivos de datos, contenido y recursos de aplicaciones para 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) GetResourceStream(Uri) GetResourceStream(Uri) GetResourceStream(Uri)

Devuelve una secuencia de recursos para un archivo de datos de recursos ubicado en el Uri especificado. Vea WPF Application Resource, Content, and Data Files (Archivos de datos, contenido y recursos de aplicaciones para 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() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
LoadComponent(Object, Uri) LoadComponent(Object, Uri) LoadComponent(Object, Uri) LoadComponent(Object, Uri)

Carga un archivo XAMLXAML que se encuentra en el identificador de recursos uniforme (URI)uniform resource identifier (URI) especificado y lo convierte en una instancia del objeto especificado por el elemento raíz del archivo XAMLXAML.Loads a XAMLXAML file that is located at the specified identificador de recursos uniforme (URI)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) LoadComponent(Uri) LoadComponent(Uri) LoadComponent(Uri)

Carga un archivo XAMLXAML ubicado en el identificador de recursos uniforme (URI)uniform resource identifier (URI) especificado y lo convierte en una instancia del objeto especificado por el elemento raíz del archivo XAMLXAML.Loads a XAMLXAML file that is located at the specified identificador de recursos uniforme (URI)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() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
OnActivated(EventArgs) OnActivated(EventArgs) OnActivated(EventArgs) OnActivated(EventArgs)

Genera el evento Activated.Raises the Activated event.

OnDeactivated(EventArgs) OnDeactivated(EventArgs) OnDeactivated(EventArgs) OnDeactivated(EventArgs)

Genera el evento Deactivated.Raises the Deactivated event.

OnExit(ExitEventArgs) OnExit(ExitEventArgs) OnExit(ExitEventArgs) OnExit(ExitEventArgs)

Genera el evento Exit.Raises the Exit event.

OnFragmentNavigation(FragmentNavigationEventArgs) OnFragmentNavigation(FragmentNavigationEventArgs) OnFragmentNavigation(FragmentNavigationEventArgs) OnFragmentNavigation(FragmentNavigationEventArgs)

Genera el evento FragmentNavigation.Raises the FragmentNavigation event.

OnLoadCompleted(NavigationEventArgs) OnLoadCompleted(NavigationEventArgs) OnLoadCompleted(NavigationEventArgs) OnLoadCompleted(NavigationEventArgs)

Genera el evento LoadCompleted.Raises the LoadCompleted event.

OnNavigated(NavigationEventArgs) OnNavigated(NavigationEventArgs) OnNavigated(NavigationEventArgs) OnNavigated(NavigationEventArgs)

Genera el evento Navigated.Raises the Navigated event.

OnNavigating(NavigatingCancelEventArgs) OnNavigating(NavigatingCancelEventArgs) OnNavigating(NavigatingCancelEventArgs) OnNavigating(NavigatingCancelEventArgs)

Genera el evento Navigating.Raises the Navigating event.

OnNavigationFailed(NavigationFailedEventArgs) OnNavigationFailed(NavigationFailedEventArgs) OnNavigationFailed(NavigationFailedEventArgs) OnNavigationFailed(NavigationFailedEventArgs)

Genera el evento NavigationFailed.Raises the NavigationFailed event.

OnNavigationProgress(NavigationProgressEventArgs) OnNavigationProgress(NavigationProgressEventArgs) OnNavigationProgress(NavigationProgressEventArgs) OnNavigationProgress(NavigationProgressEventArgs)

Genera el evento NavigationProgress.Raises the NavigationProgress event.

OnNavigationStopped(NavigationEventArgs) OnNavigationStopped(NavigationEventArgs) OnNavigationStopped(NavigationEventArgs) OnNavigationStopped(NavigationEventArgs)

Genera el evento NavigationStopped.Raises the NavigationStopped event.

OnSessionEnding(SessionEndingCancelEventArgs) OnSessionEnding(SessionEndingCancelEventArgs) OnSessionEnding(SessionEndingCancelEventArgs) OnSessionEnding(SessionEndingCancelEventArgs)

Genera el evento SessionEnding.Raises the SessionEnding event.

OnStartup(StartupEventArgs) OnStartup(StartupEventArgs) OnStartup(StartupEventArgs) OnStartup(StartupEventArgs)

Genera el evento Startup.Raises the Startup event.

Run() Run() Run() Run()

Inicia una aplicación para Windows Presentation Foundation.Starts a Windows Presentation Foundation application.

Run(Window) Run(Window) Run(Window) Run(Window)

Inicie una aplicación de Windows Presentation Foundation y abre la ventana especificada.Starts a Windows Presentation Foundation application and opens the specified window.

SetCookie(Uri, String) SetCookie(Uri, String) SetCookie(Uri, String) SetCookie(Uri, String)

Crea una cookie para la ubicación especificada por Uri.Creates a cookie for the location specified by a Uri.

Shutdown() Shutdown() Shutdown() Shutdown()

Cierra una aplicación.Shuts down an application.

Shutdown(Int32) Shutdown(Int32) Shutdown(Int32) Shutdown(Int32)

Cierra la aplicación que devuelve al sistema operativo el código de salida especificado.Shuts down an application that returns the specified exit code to the operating system.

ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)
TryFindResource(Object) TryFindResource(Object) TryFindResource(Object) TryFindResource(Object)

Busca el recurso especificado.Searches for the specified resource.

VerifyAccess() VerifyAccess() VerifyAccess() VerifyAccess()

Exige que el subproceso que realiza la llamada tenga acceso a este DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)

Eventos

Activated Activated Activated Activated

Se produce cuando una aplicación se convierte en la aplicación en primer plano.Occurs when an application becomes the foreground application.

Deactivated Deactivated Deactivated Deactivated

Se produce cuando una aplicación deja de estar en primer plano.Occurs when an application stops being the foreground application.

DispatcherUnhandledException DispatcherUnhandledException DispatcherUnhandledException DispatcherUnhandledException

Se produce cuando una aplicación inicia una excepción que no se controla.Occurs when an exception is thrown by an application but not handled.

Exit Exit Exit Exit

Se produce justo antes de que se cierre una aplicación y no se puede cancelar.Occurs just before an application shuts down, and cannot be canceled.

FragmentNavigation FragmentNavigation FragmentNavigation FragmentNavigation

Se produce cuando un navegador de la aplicación comienza a navegar hacia un fragmento de contenido, cuando la navegación se produce inmediatamente si el fragmento deseado está en el contenido actual, o bien, una vez cargado el contenido XAMLXAML de origen si el fragmento deseado está en otro contenido.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 LoadCompleted LoadCompleted LoadCompleted

Se produce cuando se ha cargado y analizado el contenido al que ha navegado un navegador de la aplicación y se ha iniciado su representación.Occurs when content that was navigated to by a navigator in the application has been loaded, parsed, and has begun rendering.

Navigated Navigated Navigated Navigated

Se produce cuando se ha encontrado el contenido al que navega un navegador de la aplicación, aunque no haya terminado de cargarse.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 Navigating Navigating Navigating

Se produce cuando un navegador de la aplicación solicita una nueva navegación.Occurs when a new navigation is requested by a navigator in the application.

NavigationFailed NavigationFailed NavigationFailed NavigationFailed

Se produce cuando se genera un error mientras que un navegador de la aplicación navega al contenido solicitado.Occurs when an error occurs while a navigator in the application is navigating to the requested content.

NavigationProgress NavigationProgress NavigationProgress NavigationProgress

Se produce periódicamente durante una descarga administrada por un navegador de la aplicación para proporcionar información sobre el progreso de la navegación.Occurs periodically during a download that is being managed by a navigator in the application to provide navigation progress information.

NavigationStopped NavigationStopped NavigationStopped NavigationStopped

Se produce cuando se llama al método StopLoading de un navegador en la aplicación, o bien, cuando un navegador solicita una nueva navegación mientras hay una navegación en curso.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 SessionEnding SessionEnding SessionEnding

Se produce cuando el usuario finaliza la sesión de Windows cerrando sesión o apagando el sistema operativo.Occurs when the user ends the Windows session by logging off or shutting down the operating system.

Startup Startup Startup Startup

Se produce cuando se llama al método Run() del objeto Application.Occurs when the Run() method of the Application object is called.

Implementaciones de interfaz explícitas

IQueryAmbient.IsAmbientPropertyAvailable(String) IQueryAmbient.IsAmbientPropertyAvailable(String) IQueryAmbient.IsAmbientPropertyAvailable(String) IQueryAmbient.IsAmbientPropertyAvailable(String)

Consulta si la propiedad de ambiente especificada está disponible en el ámbito actual.Queries for whether a specified ambient property is available in the current scope.

Se aplica a

Seguridad para subprocesos

El público static (Shared en Visual Basic) los miembros de este tipo son seguros para subprocesos.The public static (Shared in Visual Basic) members of this type are thread safe. Además, el FindResource(Object) y TryFindResource(Object) métodos y la Properties y Resources propiedades son seguros para subprocesos.In addition, the FindResource(Object) and TryFindResource(Object) methods and the Properties and Resources properties are thread safe.

Consulte también: