Aracılığıyla paylaş

Xamarin.EssentialsTercihler:

  • Makale

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

Kullanmaya başlayın

Bu API'yi kullanmaya başlamak için kitaplığın projelerinizde düzgün yüklendiğinden ve ayarlandığından emin olmak için Xamarin.Essentials kullanmaya başlama kılavuzunu okuyun.

Tercihleri Kullanma

Sınıfınızda için Xamarin.Essentials bir başvuru ekleyin:

using Xamarin.Essentials;

Tercihlerde belirli bir anahtarın değerini kaydetmek için:

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

Tercihlerden bir değer veya ayarlanmadıysa varsayılan değer almak için:

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

Tercihlerde belirli bir anahtarın mevcut olup olmadığını denetlemek 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ı sharedNameisteğe bağlı string bir parametre alır. Bu parametre, bazı kullanım örneklerinde yararlı olan tercihler için ek kapsayıcılar oluşturmak için kullanılır. Bir kullanım örneği, uygulamanızın tercihleri uzantılar arasında veya bir izleme uygulamasıyla paylaşması gerektiği durumlardır. Lütfen aşağıdaki platform uygulamasına özgü bilgileri okuyun.

Desteklenen Veri Türleri

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

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

System Ayarlar ile tümleştirme

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

Uygulama Ayrıntıları

değerleri DateTime , sınıfı tarafından DateTime tanımlanan iki yöntem kullanılarak 64 bit ikili (uzun tamsayı) biçiminde depolanır: ToBinary yöntemi değeri kodlamak DateTime için kullanılır ve FromBinary yöntemi değerin kodunu çözer. Eşgüdümlü Evrensel Saat (UTC) değeri olmayan bir DateTime depolandığında kodu çözülen değerlerde yapılabilecek ayarlamalar için bu yöntemlerin belgelerine bakın.

Platform Uygulama Özellikleri

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

Kalıcılık

Uygulamanın kaldırılması, Otomatik Yedekleme kullanan Android 6.0 (API düzeyi 23) veya sonraki sürümlerinde hedeflenen ve çalıştırılan uygulamalar dışında tüm Tercihlerin kaldırılmasına neden olur. Bu özellik varsayılan olarak açıktır ve Tercihler API'sinin kullandığı Paylaşılan Tercihler dahil olmak üzere uygulama verilerini korur. Google'ın belgelerini izleyerek bunu devre dışı bırakabilirsiniz.

Sınırlamalar

Bir dizeyi depolarken, bu API'nin az miktarda metin depolaması amaçlanmıştır. Büyük miktarda metin depolamak için kullanmaya çalışırsanız performans alt bilgisayar olabilir.

API

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