ISharedPreferences インターフェイス

定義

[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

属性

RegisterAttribute

実装

IJavaObject IJavaPeerable IDisposable

注釈

Context#getSharedPreferencesによって返される基本設定データにアクセスおよび変更するためのインターフェイス。 特定の基本設定のセットには、すべてのクライアントが共有するこのクラスの 1 つのインスタンスがあります。 基本設定の変更は、 Editor オブジェクトを経由して、ユーザー設定の値がストレージにコミットされたときに一貫した状態と制御を維持する必要があります。 さまざまな get メソッドから返されるオブジェクトは、アプリケーションによって不変として扱われる必要があります。

SharedPreferences は、ユーザーがアプリを体験する方法に関するデータを格納するのに最適です。たとえば、ユーザーが特定の UI テーマを好むか、リスト内の特定のコンテンツを表示するかグリッドで表示するかなどです。 このため、SharedPreferences は、変更が永続的に永続化される前に、Editor#commit() committedEditor#apply() appliedemEditorimmediately</em> による変更<または>を反映します。 アプリのクラッシュや終了などの状況では、 OnSharedPreferenceChangeListener が変更が成功したことが報告された場合でも、これらの変更が失われる可能性があります。 SharedPreferences は、ユーザーのセキュリティやプライバシー設定などの以前の状態へのこの種のロールバックの影響を受けやすいデータを格納する場合には推奨されません。 その他の高度なデータ永続化オプションについては、「 Room または DataStore」を参照してください。

<em>Note:</em> 一般的な実装では、ホスト アクティビティが停止したときに、基本設定ファイルに対する未処理の編集がディスクに保持されることを保証します。 状況によっては (ホスト アクティビティから移動する直前に多数の Editor#commit() 操作や Editor#apply() 操作を実行する場合など)、ライフサイクル移行イベント中にメイン スレッドがブロックされたり、関連する ANR エラーが発生したりする可能性があります。 詳細については、 Editor#commit() と Editor#apply()のドキュメントを参照してください。

<em>Note: このクラスは、複数のプロセス間での使用をサポートしていません。</em>

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

SharedPreferences の使用の詳細については、 Data Storage 開発者ガイドを参照してください。

</部>

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。