Conjuntos de ahorro de valor-clave

Esta lección le enseña a
Obtener un identificador a un SharedPreferences
Escribir en Preferencias compartidas

Uso de las preferencias compartidas

Si usted tiene una colección relativamente pequeña de los valores clave que desea guardar, usted debe utilizar las API SharedPreferences. A SharedPreferences objeto apunta a un archivo que contiene pares de valores clave y proporciona métodos sencillos para leer y escribir ellos. Cada archivo SharedPreferences es administrado por el marco y puede ser privado o compartido.

Esta clase muestra cómo utilizar las API SharedPreferences para almacenar y recuperar los valores simples.

Nota: Las API SharedPreferences son sólo para lectura y escritura de pares de valores clave y no se debe confundir con las API de preferencias, que le ayudan a construir una interfaz de usuario para la configuración de la aplicación (aunque utilizan SharedPreferences como su aplicación para guardar la configuración de la aplicación . Para obtener información sobre el uso de las API de preferencias, consulte la guía de configuración.

Obtener un identificador a un SharedPreferences
Se puede crear un nuevo archivo de preferencias de acceso compartido o una ya existente llamando a uno de dos métodos:


getSharedPreferences - Utilice esta opción si necesita múltiples archivos de preferencias compartidas identificados por su nombre, que se especifica con el primer parámetro. Puede llamar a este de cualquier contexto en su aplicación.
getPreferences - Utilice esta de una actividad si es necesario utilizar un único archivo de preferencias compartida para la actividad. Debido a que este recupera un archivo de preferencias por defecto compartido que pertenece a la actividad, no es necesario que proporcione un nombre.
Por ejemplo, el siguiente código se ejecuta dentro de un fragmento. Se accede al archivo de preferencias compartida que se identifica por la cadena de recursos R.string.preference_file_key y la abre utilizando el modo privado por lo que el archivo es accesible sólo por su aplicación.

Alternativamente, si usted necesita un solo archivo de preferencias compartida para su actividad, se puede utilizar el método getPreferences:

Precaución: Si crea un archivo de preferencias compartidas con MODE_WORLD_READABLE o MODE_WORLD_WRITEABLE, entonces cualquier otras aplicaciones que conocen el identificador de archivo pueden tener acceso a sus datos.

Escribir en Preferencias compartidas

Para escribir en un archivo de preferencias compartida, crear un SharedPreferences.Editor llamando edición en sus SharedPreferences.

Pasar las claves y valores que desea escribir con métodos tales como putInt y putString . A continuación, llame commit para guardar los cambios. Por ejemplo:

Para recuperar los valores de un archivo de preferencias compartida, llamar a métodos tales como getInt y getString, proporcionando la clave para el valor que desee y, opcionalmente, un valor por defecto para volver si la clave no está presente