Application Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Encapsula una aplicación de 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
- Herencia
- Implementaciones
Ejemplos
En el ejemplo siguiente se muestra cómo se define una aplicación estándar con solo marcado:
<Application xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" />
En el ejemplo siguiente se muestra cómo se define una aplicación estándar con solo 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
En el ejemplo siguiente se muestra cómo se define una aplicación estándar mediante una combinación de marcado y código subyacente.
<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
Comentarios
Application es una clase que encapsula WPF funcionalidad específica de la aplicación, incluido lo siguiente:
Duración de la aplicación: Activated, Current, Deactivated, DispatcherUnhandledException, ExitRunSessionEndingShutdown, ShutdownMode, . Startup
Application-Scope Window, Property y Resource Management: FindResource, GetContentStream, GetResourceStream, LoadComponent, MainWindow, Properties, Resources, StartupUri, Windows.
Command-Line Parámetro y Salida del procesamiento de código: Application.Startup, Application.Exit, Application.Shutdown.
Navegación: FragmentNavigation, LoadCompleted, , NavigatedNavigating, NavigationProgress, NavigationStoppedNavigationFailed, , SetCookieGetCookie.
Application implementa el patrón singleton para proporcionar acceso compartido a sus servicios de ventana, propiedad y ámbito de recursos. Por lo tanto, solo se puede crear una instancia de la Application clase por AppDomain.
Puede implementar un Application mediante marcado, marcado y código subyacente, o código subyacente. Si Application se implementa con marcado, ya sea marcado o marcado y código subyacente, el archivo de marcado debe configurarse como un motor de compilación de Microsoft (MSBuild) ApplicationDefinition elemento.
Note
Una aplicación independiente no requiere un Application objeto; es posible implementar un método de punto de entrada personalizado static (Main) que abra una ventana sin crear una instancia de Application. Sin embargo, las aplicaciones del explorador XAML (XBAPs) requieren un Application objeto .
Constructores
| Nombre | Description |
|---|---|
| Application() |
Inicializa una nueva instancia de la clase Application. |
Propiedades
| Nombre | Description |
|---|---|
| Current |
Obtiene el Application objeto para el objeto actual AppDomain. |
| Dispatcher |
Obtiene el objeto al que DispatcherDispatcherObject está asociado. (Heredado de DispatcherObject) |
| MainWindow |
Obtiene o establece la ventana principal de la aplicación. |
| Properties |
Obtiene una colección de propiedades de ámbito de aplicación. |
| ResourceAssembly |
Obtiene o establece el Assembly que proporciona los identificadores uniformes de recursos (URI) del paquete para los recursos de una aplicación de WPF. |
| Resources |
Obtiene o establece una colección de recursos de ámbito de aplicación, como estilos y pinceles. |
| ShutdownMode |
Obtiene o establece la condición que hace que se llame al Shutdown() método . |
| StartupUri |
Obtiene o establece una interfaz de usuario que se muestra automáticamente cuando se inicia una aplicación. |
| ThemeMode |
Obtiene o establece el modo de tema fluent de la aplicación. |
| Windows |
Obtiene las ventanas con instancias de una aplicación. |
Métodos
| Nombre | Description |
|---|---|
| CheckAccess() |
Determina si el subproceso que llama tiene acceso a este DispatcherObject. (Heredado de DispatcherObject) |
| Equals(Object) |
Determina si el objeto especificado es igual al objeto actual. (Heredado de Object) |
| FindResource(Object) |
Busca un recurso de interfaz de usuario (UI), como o StyleBrush, con la clave especificada y produce una excepción si no se encuentra el recurso solicitado (consulta Recursos XAML). |
| GetContentStream(Uri) |
Devuelve un flujo de recursos para un archivo de datos de contenido que se encuentra en el Uri especificado (vea WPF recurso de aplicación, contenido y archivos de datos). |
| GetCookie(Uri) |
Recupera una cookie para la ubicación especificada por .Uri |
| GetHashCode() |
Actúa como función hash predeterminada. (Heredado de Object) |
| GetRemoteStream(Uri) |
Devuelve un flujo de recursos para un archivo de datos de sitio de origen que se encuentra en el Uri especificado (consulte WPF recurso de aplicación, contenido y archivos de datos). |
| GetResourceStream(Uri) |
Devuelve un flujo de recursos para un archivo de datos de recursos que se encuentra en el Uri especificado (vea WPF recurso de aplicación, contenido y archivos de datos). |
| GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
| LoadComponent(Object, Uri) |
Carga un archivo XAML que se encuentra en el identificador uniforme de recursos (URI) especificado y lo convierte en una instancia del objeto especificado por el elemento raíz del archivo XAML. |
| LoadComponent(Uri) |
Carga un archivo XAML que se encuentra en el identificador uniforme de recursos (URI) especificado y lo convierte en una instancia del objeto especificado por el elemento raíz del archivo XAML. |
| MemberwiseClone() |
Crea una copia superficial del Objectactual. (Heredado de Object) |
| OnActivated(EventArgs) |
Genera el evento Activated. |
| OnDeactivated(EventArgs) |
Genera el evento Deactivated. |
| OnExit(ExitEventArgs) |
Genera el evento Exit. |
| OnFragmentNavigation(FragmentNavigationEventArgs) |
Genera el evento FragmentNavigation. |
| OnLoadCompleted(NavigationEventArgs) |
Genera el evento LoadCompleted. |
| OnNavigated(NavigationEventArgs) |
Genera el evento Navigated. |
| OnNavigating(NavigatingCancelEventArgs) |
Genera el evento Navigating. |
| OnNavigationFailed(NavigationFailedEventArgs) |
Genera el evento NavigationFailed. |
| OnNavigationProgress(NavigationProgressEventArgs) |
Genera el evento NavigationProgress. |
| OnNavigationStopped(NavigationEventArgs) |
Genera el evento NavigationStopped. |
| OnSessionEnding(SessionEndingCancelEventArgs) |
Genera el evento SessionEnding. |
| OnStartup(StartupEventArgs) |
Genera el evento Startup. |
| Run() |
Inicia una aplicación de Windows Presentation Foundation. |
| Run(Window) |
Inicia una aplicación de Windows Presentation Foundation y abre la ventana especificada. |
| SetCookie(Uri, String) |
Crea una cookie para la ubicación especificada por .Uri |
| Shutdown() |
Cierra una aplicación. |
| Shutdown(Int32) |
Cierra una aplicación que devuelve el código de salida especificado al sistema operativo. |
| ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
| TryFindResource(Object) |
Busca el recurso especificado. |
| VerifyAccess() |
Exige que el subproceso de llamada tenga acceso a este DispatcherObject. (Heredado de DispatcherObject) |
Eventos
| Nombre | Description |
|---|---|
| Activated |
Se produce cuando una aplicación se convierte en la aplicación en primer plano. |
| Deactivated |
Se produce cuando una aplicación deja de ser la aplicación en primer plano. |
| DispatcherUnhandledException |
Se produce cuando una aplicación produce una excepción, pero no se controla. |
| Exit |
Se produce justo antes de que una aplicación se cierre y no se pueda cancelar. |
| FragmentNavigation |
Se produce cuando un navegador de la aplicación comienza la navegación a un fragmento de contenido, la navegación se produce inmediatamente si el fragmento deseado está en el contenido actual o después de que se haya cargado el contenido XAML de origen si el fragmento deseado está en contenido diferente. |
| LoadCompleted |
Se produce cuando un navegador ha cargado, analizado y empezado a representar el contenido al que ha navegado un navegador de la aplicación. |
| Navigated |
Se produce cuando se encuentra el contenido al que navega un navegador en la aplicación, aunque es posible que no se haya completado la carga. |
| Navigating |
Se produce cuando un navegador solicita una nueva navegación en la aplicación. |
| NavigationFailed |
Se produce cuando se produce un error mientras un navegador de la aplicación navega al contenido solicitado. |
| NavigationProgress |
Se produce periódicamente durante una descarga administrada por un navegador de la aplicación para proporcionar información de progreso de navegación. |
| NavigationStopped |
Se produce cuando se llama al |
| SessionEnding |
Se produce cuando el usuario finaliza la sesión de Windows iniciando sesión o cerrando el sistema operativo. |
| Startup |
Se produce cuando se llama al Run() método del Application objeto . |
Implementaciones de interfaz explícitas
| Nombre | Description |
|---|---|
| IQueryAmbient.IsAmbientPropertyAvailable(String) |
Consulta si una propiedad ambiente especificada está disponible en el ámbito actual. |
Se aplica a
Seguridad para subprocesos
Los miembros públicos static (Shared en Visual Basic) de este tipo son seguros para subprocesos. Además, los FindResource(Object) métodos y y TryFindResource(Object) las Properties propiedades y Resources son seguros para subprocesos.