共用方式為

Xamarin.Essentials偏好設定:

  • 發行項

喜好設定類別可協助將應用程式喜好設定儲存於鍵/值存放區中。

開始使用

若要開始使用此 API，請閱讀 入門指南Xamarin.Essentials，以確保連結庫已正確安裝並設定在您的專案中。

使用喜好設定

在類別中新增 的 Xamarin.Essentials 參考：

using Xamarin.Essentials;

將指定「鍵」的值儲存在喜好設定中：

Preferences.Set("my_key", "my_value");

從喜好設定或預設值 (若未設定) 擷取值：

var myValue = Preferences.Get("my_key", "default_value");

若要檢查指定的 金鑰 是否存在於喜好設定中：

bool hasKey = Preferences.ContainsKey("my_key");

從喜好設定中移除「鍵」：

Preferences.Remove("my_key");

移除所有喜好設定：

Preferences.Clear();

提示

上述方法會採用稱為 sharedName的選擇性string參數。 此參數可用來為喜好設定建立其他容器，在某些使用案例中很有説明。 其中一個使用案例是您的應用程式需要跨延伸模組或監看應用程式共用喜好設定。 請閱讀下列平台實作細節。

支援的資料類型

喜好設定支援下列資料類型：

  • bool
  • double
  • int
  • float
  • long
  • string
  • DateTime

與系統設定整合

喜好設定會以原生方式儲存，可讓您將設定整合到原生系統設定中。 請遵循平台檔和範例來與平臺整合：

實作詳細資料

DateTime 值使用 DateTime 類別所定義的兩種方法，以 64 位元二進位 (長整數) 格式儲存：ToBinary 方法用於編碼 DateTime 值，而 FromBinary 方法會對值進行解碼。 請參閱這些方法的文件，以便在已儲存的 DateTime 並非國際標準時間 (UTC) 值時，對解碼值進行調整。

平台實作特性

所有資料都會儲存於共用的喜好設定中。 sharedName如果未指定 ，則會使用預設共用喜好設定，否則會使用名稱來取得具有指定名稱的私人共用喜好設定。

持續性

卸載應用程式會導致移除所有喜好設定，但例外狀況是以 Android 6.0 （API 層級 23） 或更新版本為目標且使用自動備份的應用程式執行。 根據預設，此功能為啟用並保留應用程式資料，包括「共用喜好設定」，這是喜好設定 API 使用的內容。 您可以透過下列 Google 文件 來停用此項目。

限制

儲存字串時，此 API 旨在存放少量文字。 若嘗試將其用來儲存大量文字，效能會欠佳。

API

在 Channel 9 與 YouTube 上尋找更多 Xamarin 影片。