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偏好資料的介面。 對於任何特定的偏好集合，所有用戶端都會共享這個類別的單一實例。 偏好設定的修改必須經過物件， Editor 以確保偏好值維持一致狀態並控制何時提交儲存。 從各種 get 方法回傳的物件必須被應用程式視為不可變。

SharedPreferences 最適合儲存使用者偏好如何體驗應用程式的資料，例如使用者偏好特定 UI 主題，或偏好以清單形式觀看特定內容而非格子。 為此，SharedPreferences 會立即反映變更Editor#commit() committed，或Editor#apply() applied即時Editor<><>反映，可能在這些變更持續存在之前。 在某些情況下，如應用程式當機或終止，這些變更可能會遺失，即使 OnSharedPreferenceChangeListener 報告變更已成功。 不建議使用 SharedPreferences 儲存對此類回滾敏感的資料，例如使用者安全或隱私設定。 關於其他高階資料持久化選項，請參見 Room 或 DataStore。

<em>注意：</em> 常見實作保證當主機活動停止時，對偏好設定檔案的未完成編輯會持續保存到磁碟。 在某些情況下（例如在離開主機活動前執行多項Editor#commit()Editor#apply()操作時），可能導致生命週期轉換事件及相關 ANR 錯誤阻塞主執行緒。 更多細節請參閱 Editor#commit() 和 Editor#apply()的文件。

<em>注意：此類別不支援跨多個程序使用。</em>

<div class=“特殊參考”><h3>開發者指南</h3>

欲了解更多使用 SharedPreferences 的資訊，請閱讀 資料儲存 開發指南。

</div>

Java 文件 android.content.SharedPreferences。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。