Application Clase

Definición

Espacio de nombres:

Windows.UI.Xaml

Encapsula la aplicación y sus servicios disponibles.

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Application

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class Application

Public Class Application

<Application />
 

Herencia

Object IInspectable Application

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Comentarios

La clase Application encapsula una aplicación y proporciona los siguientes servicios:

• punto de entrada de la aplicación, especialmente para varios contratos de activación
• administración de la duración de la aplicación
• recursos con ámbito de aplicación
• Detección de excepciones no controladas

El objeto Application se proporciona normalmente en el XAML inicial para App.xaml. Las plantillas de proyecto predeterminadas de Visual Studio generan una App clase que deriva de Application y proporciona un punto de entrada donde puede agregar código de inicialización.

La App clase se asocia a sí misma con el XAML correspondiente llamando al método generado InitializeComponent en su constructor. Puede agregar código de inicialización adicional al App constructor, pero normalmente solo agregará código para asociar controladores a eventos de aplicación. Para otro código de inicialización, debe invalidar uno o varios métodos de inicialización, como OnLaunched.

El sistema controla la duración de la aplicación suspendiendo la aplicación cada vez que el usuario cambia a otra aplicación o al escritorio y reanuda la aplicación cada vez que el usuario vuelve a ella. Sin embargo, el sistema también puede finalizar la aplicación mientras se suspende para liberar recursos. Debes controlar el evento Suspending para guardar el estado de la aplicación en caso de finalización e invalidar el método OnLaunched para restaurar el estado de la aplicación. Debe controlar el evento Resuming solo si necesita actualizar cualquier contenido mostrado que pueda haber cambiado mientras se suspende la aplicación. No es necesario restaurar otro estado de la aplicación cuando se reanude la aplicación.

Debido a su posición en el modelo de aplicación, codegen y secuencia de activación, Application tiene algunas restricciones en su uso xaml:

• Aparte de las declaraciones xmlns y x:Class, ningún otro atributo puede aparecer en la Application etiqueta raíz.
• No intente cambiar los valores x:Class que proceden de las páginas App.xaml de la plantilla de proyecto, hay dependencias adicionales en el uso de ese esquema de nomenclatura que existen en las acciones de compilación.
• No conecte los controladores de eventos application en XAML. Todo el cableado de eventos debe realizarse en el código (normalmente en el constructor). Además, normalmente se usan invalidaciones de método en lugar de sintaxis de eventos para un evento (por ejemplo, se invalida OnActivated para responder a esa fase del ciclo de vida de la aplicación).
• Las únicas propiedades esperadas en una instancia de Application en XAML son el conjunto de elementos para rellenar la propiedad Application.Resources , mediante un uso de elementos de propiedad XAML. Para obtener más información, consulta Recursos. Para proporcionar control general de errores para las excepciones que el código de la aplicación no detecta, controle el evento UnhandledException .

Nota

El archivo principal de la aplicación debe denominarse App.xaml.

Historial de versiones

Versión de Windows	Versión del SDK	Valor agregado
1607	14393	EnteredBackground
1607	14393	FocusVisualKind
1607	14393	LeavingBackground
1607	14393	OnBackgroundActivated
1607	14393	RequiresPointerMode
1703	15063	HighContrastAdjustment

Constructores

Application()

Inicializa una nueva instancia de la clase Application .

Propiedades

Current	Obtiene el objeto Application de la aplicación actual.
DebugSettings	Obtiene un objeto que declara cómo se comporta la aplicación cuando se ejecuta en un entorno de depuración.
FocusVisualKind	Obtiene o establece el tipo de comentarios visuales que una aplicación puede usar para indicar el elemento de interfaz de usuario con foco. Esta propiedad solo es válida para dispositivos de entrada que pueden generar eventos clave, como un teclado o un panel de juegos.
HighContrastAdjustment	Obtiene o establece un valor que indica si el marco ajusta automáticamente las propiedades visuales cuando se habilitan los temas de contraste alto.
RequestedTheme	Obtiene o establece un valor que determina la preferencia claro-oscuro para el tema general de una aplicación.
RequiresPointerMode	Obtiene o establece si una aplicación para UWP admite el modo de mouse, que emula experiencias de interacción de puntero con dispositivos de entrada que no son de puntero, como un panel de juegos o un control remoto. (Todos los elementos anidados heredan este comportamiento).
Resources	Obtiene una colección de recursos con ámbito de aplicación, como estilos, plantillas y pinceles.

Métodos

Exit()	Cierra la aplicación.
LoadComponent(Object, Uri, ComponentResourceLocation)	Carga un archivo XAML que se encuentra en la ubicación relativa especificada y lo convierte en una instancia del objeto especificado por el elemento raíz del archivo XAML.
LoadComponent(Object, Uri)	Carga un archivo XAML que se encuentra en la ubicación relativa especificada y lo convierte en una instancia del objeto especificado por el elemento raíz del archivo XAML.
OnActivated(IActivatedEventArgs)	Se invoca cuando la aplicación se activa por algún medio que no sea el inicio normal.
OnBackgroundActivated(BackgroundActivatedEventArgs)	Se invoca cuando la aplicación se activa en segundo plano.
OnCachedFileUpdaterActivated(CachedFileUpdaterActivatedEventArgs)	Se invoca cuando la aplicación se activa debido a un contrato de activación con ActivationKind como CachedFileUpdater.
OnFileActivated(FileActivatedEventArgs)	Se invoca cuando la aplicación se activa a través de la apertura de archivos.
OnFileOpenPickerActivated(FileOpenPickerActivatedEventArgs)	Se invoca cuando la aplicación se activa a través de la asociación de cuadros de diálogo abiertos por archivos.
OnFileSavePickerActivated(FileSavePickerActivatedEventArgs)	Se invoca cuando la aplicación se activa a través de la asociación de cuadros de diálogo de guardado de archivos.
OnLaunched(LaunchActivatedEventArgs)	Se invoca cuando se inicia la aplicación. Invalide este método para realizar la inicialización de la aplicación y mostrar el contenido inicial en la ventana asociada.
OnSearchActivated(SearchActivatedEventArgs)	Se invoca cuando la aplicación se activa a través de una asociación de búsqueda.
OnShareTargetActivated(ShareTargetActivatedEventArgs)	Se invoca cuando la aplicación se activa mediante la asociación de uso compartido.
OnWindowCreated(WindowCreatedEventArgs)	Se invoca cuando la aplicación crea una ventana.
Start(ApplicationInitializationCallback)	Proporciona el punto de entrada y la inicialización de solicitudes de la aplicación. Use la devolución de llamada para crear instancias de la clase Application .

Eventos

EnteredBackground	Se produce cuando la aplicación pasa del primer plano al fondo.
LeavingBackground	Se produce cuando la aplicación se mueve del fondo al primer plano.
Resuming	Se produce cuando la aplicación pasa del estado Suspendido al estado En ejecución.
Suspending	Se produce cuando la aplicación pasa al estado Suspendido de algún otro estado.
UnhandledException	Se produce cuando el código de la aplicación puede controlar una excepción, tal como se reenvía desde un error de Windows Runtime de nivel nativo. Las aplicaciones pueden marcar la repetición como se controla en los datos de eventos.

Consulte también

• Window
• Controlar la activación de aplicaciones
• Controlar la suspensión de aplicaciones
• Controlar la reanudación de aplicaciones