Application Clase

Definición

Espacio de nombres:
Microsoft.UI.Xaml
Editar

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

Normalmente, el Application objeto se proporciona en el XAML inicial de 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 .

Tip

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 de x:Class que proceden de las páginas App.xaml de la plantilla de proyecto, hay dependencias adicionales sobre 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 , usando un uso de elemento 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 .

Note

El Application archivo principal debe denominarse App.xaml.

Constructores

Nombre Description
Application()

Inicializa una nueva instancia de la clase Application .

Propiedades

Nombre Description
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 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 de oscuridad clara 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

Nombre Description
Exit()

Apaga 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 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

Nombre Description
ResourceManagerRequested

Se produce durante el inicio de un nuevo subproceso de WinUI para que proporcione 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, como se reenvía desde un error de Windows Runtime de nivel nativo. Las aplicaciones pueden marcar la repetición como controlada en los datos de eventos.

Se aplica a

Consulte también