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í.
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 ApplicationPublic Class Application<Application />
- Herencia
- Atributos
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
Applicationetiqueta 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
Applicationcontroladores 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
Applicationinstancia 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 |
| 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. |