ISharedPreferences Interface

Définition

[Android.Runtime.Register("android/content/SharedPreferences", "", "Android.Content.ISharedPreferencesInvoker")]
public interface ISharedPreferences : Android.Runtime.IJavaObject, IDisposable, Java.Interop.IJavaPeerable

[<Android.Runtime.Register("android/content/SharedPreferences", "", "Android.Content.ISharedPreferencesInvoker")>]
type ISharedPreferences = interface
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Attributs

RegisterAttribute

Implémente

IJavaObject IJavaPeerable IDisposable

Remarques

Interface permettant d’accéder aux données de préférence retournées par Context#getSharedPreferences. Pour tout ensemble particulier de préférences, il existe une instance unique de cette classe que tous les clients partagent. Les modifications apportées aux préférences doivent passer par un Editor objet pour garantir que les valeurs de préférence restent dans un état et un contrôle cohérents lorsqu’elles sont validées dans le stockage. Les objets retournés par les différentes get méthodes doivent être traités comme immuables par l’application.

SharedPreferences convient le mieux au stockage des données sur la façon dont l’utilisateur préfère expérimenter l’application, par exemple, si l’utilisateur préfère un thème d’interface utilisateur particulier ou s’il préfère afficher du contenu particulier dans une liste ou une grille. À cette fin, SharedPreferences reflète les modifications Editor#commit() committed ou Editor#apply() applied par Editors <em>immédiatement/em<, potentiellement> avant que ces modifications ne soient durablement persistantes. Dans certaines circonstances, telles que les blocages d’application ou l’arrêt de ces modifications peuvent être perdus, même si une OnSharedPreferenceChangeListener modification signalée a réussi. SharedPreferences n’est pas recommandé pour le stockage de données sensibles à ce type de restauration à un état antérieur tel que la sécurité utilisateur ou les paramètres de confidentialité. Pour obtenir d’autres options de persistance des données de haut niveau, consultez Salle ou Magasin de données.

<em>Remarque :</em> Implémentations courantes garantissent que les modifications en attente des fichiers de préférence sont conservées sur le disque lorsque les activités de l’hôte sont arrêtées. Dans certaines situations (par exemple, effectuer de nombreuses Editor#commit() opérations Editor#apply() juste avant de naviguer loin de l’activité hôte) peut entraîner le blocage du thread principal pendant les événements de transition de cycle de vie et les erreurs ANR associées. Pour plus d’informations, consultez la documentation pour Editor#commit() et Editor#apply().

<em>Remarque : cette classe ne prend pas en charge l’utilisation entre plusieurs processus.</em>

<div class="special reference"><h3>Developer Guides</h3>

Pour plus d’informations sur l’utilisation de SharedPreferences, consultez le guide du développeur stockage de données .

<Commande /div>

Java documentation pour android.content.SharedPreferences.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.