Xamarin.Essentials: Tercihler

  • Makale
  • Okumak için 2 dakika

Tercihler sınıfı, uygulama tercihlerini bir anahtar/değer deposuna depolamaya yardımcı olur.

başlarken

Bu API'yi kullanmaya başlamak için kitaplığın projelerinize düzgün bir şekilde yük olduğundan ve ayar olduğundan emin olmak için başlangıç kılavuzunu okuyun.

Tercihleri Kullanma

sınıfınıza Xamarin.Essentials bir başvuru ekleyin:

using Xamarin.Essentials;

Tercihlerde verilen anahtar için bir değer kaydetmek için:

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

Ayarlanmazsa, tercihlerden veya varsayılan değerlerden bir değer almak için:

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

Tercihlerde verilen bir anahtarın mevcut olup olduğunu kontrol etmek için:

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

Anahtarı tercihlerden kaldırmak için:

Preferences.Remove("my_key");

Tüm tercihleri kaldırmak için:

Preferences.Clear();

İpucu

Yukarıdaki yöntemler adlı isteğe bağlı bir string parametre sharedName alır. Bu parametre, bazı kullanım örnekleri için yararlı olan tercihler için ek kapsayıcılar oluşturmak için kullanılır. Kullanım örneklerinden biri, uygulamanın tercihleri uzantılar arasında veya bir izleme uygulamasıyla paylaşması gereken durum olabilir. Lütfen aşağıdaki platform uygulamasına özgü özellikleri okuyun.

Desteklenen Veri Türleri

Aşağıdaki veri türleri Tercihler'de de desteklene:

  • bool
  • double
  • int
  • float
  • long
  • string
  • Tarih Saat

System Ayarlar ile tümleştirin

Tercihler yerel olarak depolanır ve bu sayede ayarlarınızı yerel sistem ayarlarıyla tümleştirebilirsiniz. Platformla tümleşmek için platform belgelerini ve örneklerini izleyin:

Uygulama Ayrıntıları

değerleri, sınıfı tarafından tanımlanan iki yöntem kullanılarak 64 bit ikili (uzun tamsayı) biçiminde depolanır: yöntemi değeri kodlamak için kullanılır ve yöntemi değerin kodunu DateTimeDateTimeToBinaryDateTimeFromBinary çözmektedir. Bu yöntemlerin belgelerine bakarak kodu çözülen değerler için bir (UTC) değeri depolanmazken yapılacak DateTime ayarlamalar Eşgüdümlü Evrensel Saat bakın.

Platform Uygulama Özellikleri

Tüm veriler Paylaşılan Tercihler'de depolanır. Belirtilmezse varsayılan paylaşılan tercihler kullanılır, aksi takdirde ad, belirtilen adla özel sharedName paylaşılan tercihler almak için kullanılır. sharedName

Kalıcılık

Uygulamayı kaldırmak, Otomatik Yedekleme kullanan Android 6.0 (API düzeyi 23) veya sonraki bir sürümünü hedef alan ve üzerinde çalıştırılan uygulamalar hariç olmak üzere tüm Tercihlerin kaldırılmasına neden olur. Bu özellik varsayılan olarak açıktır ve Tercihler API'sini kullanan Paylaşılan Tercihler de dahil olmak üzere uygulama verilerini korur. Bunu devre dışı bırakmak için Google'ın belgelerini kullanabilirsiniz.

Sınırlamalar

Bu API, bir dizeyi depolarken küçük miktarlarda metin depolamaya yöneliktir. Büyük miktarlardaki metinleri depolamak için kullanmayı denersanız performans alt olabilir.

API

Channel 9 ve YouTube'da daha fazla Xamarin videosu bulun.