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 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 ApplicationPublic Class Application<Application />
- Herencia
- Atributos
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
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 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.
|
| 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. |