ISharedPreferences Interfaccia

Definizione

[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

Attributi

RegisterAttribute

Implementazioni

IJavaObject IJavaPeerable IDisposable

Commenti

Interfaccia per l'accesso e la modifica dei dati delle preferenze restituiti da Context#getSharedPreferences. Per qualsiasi particolare set di preferenze, è presente una singola istanza di questa classe che tutti i client condividono. Le modifiche alle preferenze devono passare attraverso un Editor oggetto per garantire che i valori delle preferenze rimangano in uno stato coerente e controllare quando viene eseguito il commit nell'archiviazione. Gli oggetti restituiti dai vari get metodi devono essere considerati non modificabili dall'applicazione.

SharedPreferences è più adatto per archiviare i dati su come l'utente preferisce sperimentare l'app, ad esempio se l'utente preferisce un tema specifico dell'interfaccia utente o se preferisce visualizzare un determinato contenuto in un elenco rispetto a una griglia. A questo scopo, SharedPreferences riflette le modifiche Editor#commit() committed o Editor#apply() applied da Editors <em immediatamente</em>>, potenzialmente prima che tali modifiche vengano mantenute in modo permanente. In alcune circostanze, ad esempio arresti anomali dell'app o terminazione, queste modifiche potrebbero andarsi perse, anche se è OnSharedPreferenceChangeListener stata segnalata una modifica riuscita. SharedPreferences non è consigliato per l'archiviazione dei dati sensibili a questo tipo di rollback a uno stato precedente, ad esempio le impostazioni di sicurezza degli utenti o privacy. Per altre opzioni di persistenza dei dati di alto livello, vedere Room o DataStore.

<em>Note:</em> Le implementazioni comuni garantiscono che le modifiche in sospeso ai file di preferenza vengano mantenute su disco quando le attività host vengono arrestate. In alcune situazioni (ad esempio, l'esecuzione di molte Editor#commit() operazioni o Editor#apply() solo prima di uscire dall'attività host) ciò può causare il blocco del thread principale durante gli eventi di transizione del ciclo di vita e gli errori ANR associati. Per altri dettagli, vedere la documentazione di Editor#commit() e Editor#apply().

<em>Nota: questa classe non supporta l'uso tra più processi.</em>

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

Per altre informazioni sull'uso di SharedPreferences, vedere la Guida per sviluppatori di Archiviazione dati .

</div>

per android.content.SharedPreferences.

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.