Guardar y cargar la configuración en una aplicación para UWP

En este tema se describe lo que necesita saber para empezar a cargar y guardar la configuración en una aplicación de Plataforma universal de Windows (UWP). Se presentan las API principales y se proporcionan vínculos para ayudarle a obtener más información.

Usa la configuración para recordar los aspectos personalizables por el usuario de la aplicación. Por ejemplo, un lector de noticias podría usar la configuración de la aplicación para guardar qué fuentes de noticias mostrar y qué fuente usar para leer artículos.

Veremos el código para guardar y cargar la configuración de la aplicación.

¿Qué necesita saber?

Use la configuración de la aplicación para almacenar datos de configuración, como preferencias de usuario y estado de la aplicación.

Los siguientes tipos de datos se pueden usar con las configuraciones: enteros, dobles, flotantes, caracteres, cadenas, puntos, fechas y horas, etc. También puede almacenar instancias de la clase ApplicationDataCompositeValue que resulta útil cuando hay varias configuraciones que se deben tratar como una unidad. Por ejemplo, un nombre de fuente y un tamaño de punto para mostrar texto en el panel de lectura de la aplicación debe guardarse o restaurarse como una sola unidad. Esto impide que una configuración se desincronice con la otra debido al acceso simultáneo, como entre el programa principal y una tarea en segundo plano.

Estas son las API principales que debe conocer para guardar o cargar la configuración de la aplicación:

• Windows.Storage.ApplicationData.Current.LocalSettings obtiene el contenedor de configuración de la aplicación del almacén de datos de la aplicación local. La configuración almacenada aquí se mantiene en el dispositivo y se conserva de forma confiable a través de las actualizaciones de la aplicación.
• Windows. Storage.ApplicationData.Current.RoamingSettings obtiene el contenedor de configuración de la aplicación del almacén de datos de la aplicación móvil. La configuración almacenada aquí ya no se mueve (a partir de Windows 11), pero el almacén de configuración sigue estando disponible. El reemplazo recomendado para RoamingSettings es Azure App Service. Azure App Service es ampliamente compatible, bien documentado, confiable y admite escenarios multiplataforma o entre ecosistemas, como iOS, Android y web.
• Windows. Storage.ApplicationDataContainer es un contenedor que representa la configuración de la aplicación como pares clave-valor. Use esta clase para crear y recuperar valores de configuración.
• Windows. Storage.ApplicationDataCompositeValue representa varias opciones de configuración de la aplicación que se deben serializar como una unidad. Esto resulta útil cuando una configuración no se debe actualizar independientemente de otra.

Guardar la configuración de la aplicación

Para esta introducción, nos centraremos en dos escenarios sencillos: guardar y cargar una configuración de aplicación sencilla, y guardar y cargar una configuración de tamaño de fuente o fuente compuesta.

ApplicationDataContainer localSettings = Windows.Storage.ApplicationData.Current.LocalSettings;

// Save a setting locally on the device
localSettings.Values["test setting"] = "a device specific setting";

// Save a composite setting locally on the device
Windows.Storage.ApplicationDataCompositeValue composite = new Windows.Storage.ApplicationDataCompositeValue();
composite["Font"] = "Calibri";
composite["FontSize"] = 11;
localSettings.Values["FontInfo"] = composite;

Guarda una configuración obteniendo primero un ApplicationDataContainer para el almacenamiento de configuraciones locales con Windows.Storage.ApplicationData.Current.LocalSettings. Los pares de diccionario clave-valor que se asignan a esta instancia se guardan en el almacén de datos de configuración del dispositivo local.

En el fragmento de código anterior, applicationDataCompositeValue almacena varios pares clave-valor. Los valores compuestos son útiles cuando tiene varias configuraciones que no deben salir de la sincronización entre sí. Al guardar un applicationDataCompositeValue, los valores se guardan y cargan como una unidad o de forma atómica. De este modo, la configuración relacionada no dejará de sincronizarse.

Carga de la configuración de la aplicación

ApplicationDataContainer localSettings = Windows.Storage.ApplicationData.Current.LocalSettings;

// load a setting that is local to the device
String localValue = localSettings.Values["test setting"] as string;

// load a composite setting
Windows.Storage.ApplicationDataCompositeValue composite = (ApplicationDataCompositeValue)localSettings.Values["FontInfo"];
if (composite != null)
{
    String fontName = composite["Font"] as string;
    int fontSize = (int)composite["FontSize"];
}

Cargue una configuración obteniendo primero una instancia de ApplicationDataContainer para el almacén de datos de configuración local con Windows.Storage.ApplicationData.Current.LocalSettings. Después, úselo para recuperar pares clave-valor. Si los datos no están presentes, obtendrá un objeto NULL. En C#, esto significa que el localValue se convertirá en null si la configuración no existe.

Cargue una configuración compuesta siguiendo un patrón similar. Acceda a pares clave-valor desde el almacén de datos de configuración local. Si los datos no están presentes, obtendrá un applicationDataContainer nulo. Por eso hay una verificación de if (composite != null) en el código de ejemplo anterior.

API y documentos útiles

Este es un resumen rápido de las API y otra documentación útil para ayudarle a empezar a guardar y cargar la configuración de la aplicación.

API útiles

Documentos útiles

Ejemplos de código útiles