Looking for android Answers? Try Ask4KnowledgeBase
Looking for android Keywords? Try Ask4Keywords

AndroidDes préférences partagées


Introduction

SharedPreferences permet de sauvegarder des données sur le disque sous la forme de paires clé-valeur .

Syntaxe

  • Méthode de contexte

    • public SharedPreferences getSharedPreferences (nom de chaîne, mode int)
  • Méthode d'activité

    • public SharedPreferences getPreferences ()
  • Méthodes SharedPreferences

    • public SharedPreferences.Editor edit ()
    • booléen public contient ()
    • carte publique <String,?> getAll ()
    • boolean public getBoolean (clé de chaîne, booléen defValue)
    • float public getFloat (clé String, float defValue)
    • public int getInt (clé de chaîne, int defValue)
    • public long getLong (clé de chaîne, long defValue)
    • public String getString (clé de chaîne, String defValue)
    • public Set getStringSet (clé de chaîne, Set defValues)
    • public void registerOnSharedPreferenceChangeListener (auditeur SharedPreferences.OnSharedPreferenceChangeListener)
    • void public unregisterOnSharedPreferenceChangeListener (auditeur SharedPreferences.OnSharedPreferenceChangeListener)
  • Méthodes SharedPreferences.Editor

    • annulation publique appliquer ()
    • commit booléen public ()
    • public SharedPreferences.Editor clear ()
    • public SharedPreferences.Editor putBoolean (clé de chaîne, valeur booléenne)
    • public SharedPreferences.Editor putFloat (clé de chaîne, valeur flottante)
    • public SharedPreferences.Editor putInt (clé de chaîne, valeur int)
    • public SharedPreferences.Editor putLong (clé de chaîne, valeur longue)
    • public SharedPreferences.Editor putString (clé de chaîne, valeur de chaîne)
    • public SharedPreferences.Editor putStringSet (clé de chaîne, valeurs définies)
    • public SharedPreferences.Editor remove (Clé de chaîne)

Paramètres

Paramètre Détails
clé Une String non nulle identifiant le paramètre. Il peut contenir des espaces ou des éléments non imprimables. Ceci n'est utilisé que dans votre application (et dans le fichier XML), il n'est donc pas nécessaire qu'il soit placé dans un répertoire, mais c'est une bonne idée de l'avoir comme constante dans votre code source. Ne le localisez pas.
defValue Toutes les fonctions get prennent une valeur par défaut, qui est retournée si la clé donnée n'est pas présente dans les SharedPreferences . Il n'est pas retourné si la clé est présente mais la valeur a le mauvais type: dans ce cas, vous obtenez une ClassCastException .

Remarques

  • SharedPreferences ne doit pas être utilisé pour stocker une grande quantité de données. A ces fins, il est préférable d'utiliser SQLiteDatabase .

  • SharedPreferences est un processus unique uniquement, sauf si vous utilisez le mode obsolète MODE_MULTI_PROCESS . Donc, si votre application dispose de plusieurs processus, vous ne pourrez pas lire les SharedPreferences du processus principal dans un autre processus. Dans de tels cas, vous devez utiliser un autre mécanisme pour partager des données entre les processus, mais n'utilisez pas MODE_MULTI_PROCESS car il n'est pas fiable ni obsolète.

  • Il est préférable d'utiliser l'instance SharedPreferences dans la classe Singleton pour accéder à l'ensemble du context l'application. Si vous voulez l'utiliser uniquement pour une activité particulière, rendez-vous sur getPreferences() .

  • Évitez de stocker des informations sensibles en texte clair lorsque vous utilisez SharedPreferences car il peut être lu facilement.

Documentation officielle

https://developer.android.com/reference/android/content/SharedPreferences.html

Des préférences partagées Exemples Liés