Application Clase

Definición

Espacio de nombres:

Microsoft.UI.Xaml

Representa la aplicación actual y sus servicios disponibles.

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 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(Microsoft.UI.Xaml.WinUIContract), 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

Comentarios

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

• punto de entrada de la aplicación
• recursos con ámbito de aplicación
• Detección de excepciones no controladas

El Application objeto 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 un controlador para el evento UnhandledException o establecer requestedTheme. Debe colocar otro código de inicialización en la invalidación del método OnLaunched .

Sugerencia

Para obtener más información, consulta SDK de Aplicaciones para Windows ciclo de vida de 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 de 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 Application controladores de eventos en XAML. Todo el cableado de eventos debe realizarse en el código (normalmente en el constructor).
• Las únicas propiedades esperadas en una Application instancia de 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 Application archivo principal debe tener el nombre App.xaml.

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.
DispatcherShutdownMode	Obtiene o establece un valor que especifica si el bucle de eventos DispatcherQueue se cierra cuando se cierran todas las ventanas XAML de un subproceso.
FocusVisualKind	Obtiene o establece el tipo de comentarios visuales que una aplicación puede usar para indicar el elemento de la interfaz de usuario que tiene el foco.
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.
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.
OnLaunched(LaunchActivatedEventArgs)	Se invoca cuando se inicia la aplicación. Invalide este método para realizar la inicialización de la aplicación y para crear una nueva ventana.
Start(ApplicationInitializationCallback)	Proporciona el punto de entrada y la inicialización de solicitudes de la aplicación. Use la applicationInitializationCallback especificada para crear una instancia de la clase Application .

Eventos

ResourceManagerRequested	Se produce durante el inicio de un nuevo subproceso de WinUI para permitirle proporcionar una implementación personalizada IResourceManager que usará el marco para resolver los URI de recursos.
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
• ciclo de vida de SDK de Aplicaciones para Windows aplicación