Xamarin.EssentialsPředvolby:
Třída Preferences pomáhá ukládat předvolby aplikace do úložiště klíč/hodnota.
Začínáme
Pokud chcete začít používat toto rozhraní API, přečtěte si úvodní příručkuXamarin.Essentials, abyste měli jistotu, že je knihovna správně nainstalovaná a nastavená ve vašich projektech.
Použití předvoleb
Přidejte do Xamarin.Essentials předmětu odkaz:
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řebírají volitelný string parametr s názvem sharedName. Tento parametr slouží k vytvoření dalších kontejnerů pro předvolby, které jsou užitečné v některých případech použití. Jedním z případů použití je, když vaše aplikace potřebuje sdílet předvolby napříč rozšířeními nebo kukátkem. Přečtěte si níže uvedené specifika implementace platformy.
Podporované datové typy
Předvolby podporují následující datové typy:
- bool
- double
- int
- float
- long
- string
- Datetime
Integrace se systémovou Nastavení
Předvolby se ukládají nativně, což umožňuje integrovat nastavení do nastavení nativního systému. Při integraci s platformou postupujte podle dokumentace a ukázek platformy:
- Apple: Implementace sady Nastavení pro iOS
- Ukázka předvoleb aplikací pro iOS
- Nastavení watchOS
- Android: Začínáme s obrazovkami Nastavení
Podrobnosti implementace
DateTime Hodnoty jsou uloženy v 64bitovém binárním (dlouhém celočíselném) formátu pomocí dvou metod definovaných DateTime třídou: Metoda ToBinary se používá ke kódování DateTime hodnoty a FromBinary metoda dekóduje hodnotu. Podívejte se do dokumentace těchto metod pro úpravy, které mohou být provedeny dekódované hodnoty, pokud DateTime je uložena, která není hodnotou koordinovaného univerzálního času (UTC).
Specifika implementace platformy
Všechna data se ukládají do sdílených předvoleb. Pokud není zadána žádná sharedName výchozí sdílená předvolba, použije se v opačném případě název k získání privátních sdílených předvoleb se zadaným názvem.
Uchování
Odinstalace aplikace způsobí odebrání všech předvoleb s výjimkou aplikací, které cílí na Android 6.0 (úroveň rozhraní API 23) nebo novější, které používají automatické zálohování. Tato funkce je ve výchozím nastavení zapnutá a zachovává data aplikací včetně sdílených předvoleb, což je to, co rozhraní API předvoleb využívá. 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čí, pokud se ho pokusíte použít k ukládání velkého množství textu.