ISharedPreferences Interfaz

Definición

[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

Atributos

RegisterAttribute

Implementaciones

IJavaObject IJavaPeerable IDisposable

Comentarios

Interfaz para acceder a los datos de preferencia y modificarlos devueltos por Context#getSharedPreferences. Para cualquier conjunto determinado de preferencias, hay una única instancia de esta clase que comparten todos los clientes. Las modificaciones en las preferencias deben pasar por un Editor objeto para asegurarse de que los valores de preferencia permanecen en un estado y control coherentes cuando se confirman en el almacenamiento. La aplicación debe tratar los objetos que se devuelven de los distintos get métodos como inmutables.

SharedPreferences es más adecuado para almacenar datos sobre cómo prefiere el usuario experimentar la aplicación, por ejemplo, si el usuario prefiere un tema de interfaz de usuario determinado o si prefiere ver contenido determinado en una lista frente a una cuadrícula. A este fin, SharedPreferences refleja los cambios Editor#commit() committed o Editor#apply() applied por Editors <em>inmediatamente</em>, potencialmente antes de que esos cambios se conserven de forma duradera. En algunas circunstancias, como bloqueos de aplicación o finalización, estos cambios se pueden perder, incluso si se OnSharedPreferenceChangeListener ha notificado que el cambio se ha realizado correctamente. No se recomienda SharedPreferences para almacenar datos que sean confidenciales a este tipo de reversión a un estado anterior, como la configuración de privacidad o seguridad del usuario. Para ver otras opciones de persistencia de datos de alto nivel, consulte Sala o Almacén de datos.

<Em>Note:</em> Implementaciones comunes garantizan que las ediciones pendientes de los archivos de preferencias se conserven en el disco cuando se detengan las actividades del host. En algunas situaciones (por ejemplo, realizar muchas Editor#commit() operaciones o Editor#apply() justo antes de salir de la actividad del host), esto puede provocar el bloqueo del subproceso principal durante los eventos de transición del ciclo de vida y los errores anr asociados. Para obtener más información, consulte la documentación de Editor#commit() y Editor#apply().

<Em>Note: Esta clase no admite el uso en varios procesos.</em>

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

Para obtener más información sobre el uso de SharedPreferences, lea la guía para desarrolladores de Data Storage .

</div>

Java documentación para android.content.SharedPreferences.

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.