Xamarin.Essentials: Předvolby

  • Článek
  • 2 min ke čtení

Třída Preferences pomáhá ukládat předvolby aplikace do úložiště párů klíč-hodnota.

Začínáme

Pokud chcete začít používat toto rozhraní API, přečtěte si příručku Začínáme pro a ujistěte se, že je knihovna správně nainstalovaná a nastavená ve vašich projektech.

Použití předvoleb

Do třídy Xamarin.Essentials přidejte odkaz na :

using Xamarin.Essentials;

Uložení hodnoty pro daný klíč v předvolbách:

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

Načtení hodnoty z předvoleb nebo výchozí hodnoty, pokud není nastavená:

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

Pokud chcete zkontrolovat, jestli daný klíč existuje v předvolbách:

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

Odebrání klíče z předvoleb:

Preferences.Remove("my_key");

Odebrání všech předvoleb:

Preferences.Clear();

Tip

Výše uvedené metody převezměte volitelný parametr string s názvem sharedName . Tento parametr slouží k vytvoření dalších kontejnerů pro předvolby, které jsou v některých případech použití užitečné. Jedním z případů použití je, že vaše aplikace potřebuje sdílet předvolby mezi rozšířeními nebo s aplikací sledování. Přečtěte si níže uvedené specifika implementace platformy.

Podporované datové typy

V předvolbách jsou podporované následující datové typy:

  • bool
  • double
  • int
  • float
  • long
  • řetězec
  • Datum a čas

Integrace se System Nastavení

Předvolby se ukládají nativně, což vám umožní integrovat nastavení do nastavení nativního systému. Při integraci s platformou postupujte podle dokumentace k platformě a ukázek:

Podrobnosti implementace

Hodnoty se ukládají ve 64bitovém binárním formátu (long integer) pomocí dvou metod definovaných třídou: Metoda se používá ke kódování hodnoty a metoda dekóduje DateTimeDateTimeToBinaryDateTimeFromBinary hodnotu. V dokumentaci k těmto metodám najdete úpravy, které se můžou provést u dekódovaných hodnot, pokud je uložený objekt , který není hodnotou koordinovaného DateTime univerzálního času (UTC).

Specifika implementace platformy

Všechna data se ukládají do sdílených předvoleb. Pokud není zadaná hodnota no, použije se výchozí sdílené předvolby, jinak se název použije k získání privátních sdílených předvoleb se sharedName zadaným názvem. sharedName

Trvalosti

Odinstalace aplikace způsobí odebrání všech předvoleb s výjimkou aplikací, které cílí na Android 6.0 (úroveň 23) nebo novější a používají automatické zálohování. Tato funkce je ve výchozím nastavení povolená a zachovává data aplikací včetně sdílených předvoleb ,což využívá rozhraní API pro předvolby. Můžete to zakázat podle dokumentace Googlu.

Omezení

Při ukládání řetězce je toto rozhraní API určené k ukládání malých objemů textu. Výkon může být dílčím ukazatelem, pokud se ho pokusíte použít k ukládání velkých objemů textu.

rozhraní API

Další videa o Xamarinu najdete na Channel 9 a YouTube.