Udostępnij za pośrednictwem

Xamarin.EssentialsPreferencje:

  • Artykuł

Klasa Preferencje ułatwia przechowywanie preferencji aplikacji w magazynie kluczy/wartości.

Rozpocznij

Aby rozpocząć korzystanie z tego interfejsu API, przeczytaj przewodnik wprowadzający , Xamarin.Essentials aby upewnić się, że biblioteka jest prawidłowo zainstalowana i skonfigurowana w projektach.

Korzystanie z preferencji

Dodaj odwołanie do Xamarin.Essentials klasy:

using Xamarin.Essentials;

Aby zapisać wartość danego klucza w preferencjach:

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

Aby pobrać wartość z preferencji lub wartość domyślna, jeśli nie zostanie ustawiona:

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

Aby sprawdzić, czy dany klucz istnieje w preferencjach:

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

Aby usunąć klucz z preferencji:

Preferences.Remove("my_key");

Aby usunąć wszystkie preferencje:

Preferences.Clear();

Napiwek

Powyższe metody przyjmują opcjonalny string parametr o nazwie sharedName. Ten parametr służy do tworzenia dodatkowych kontenerów dla preferencji, które są przydatne w niektórych przypadkach użycia. Jednym z przypadków użycia jest to, że aplikacja musi udostępniać preferencje między rozszerzeniami lub aplikacją zegarka. Zapoznaj się z poniższymi specyfikami implementacji platformy.

Obsługiwane typy danych

Następujące typy danych są obsługiwane w obszarze Preferencje:

  • bool
  • double
  • int
  • float
  • long
  • string
  • Data/godzina

Integracja z ustawieniami systemu

Preferencje są przechowywane natywnie, co pozwala zintegrować ustawienia z ustawieniami systemu natywnego. Postępuj zgodnie z dokumentacją platformy i przykładami, aby zintegrować się z platformą:

Szczegóły implementacji

DateTime Wartości są przechowywane w 64-bitowym formacie binarnym (długa liczba całkowita) przy użyciu dwóch metod zdefiniowanych przez DateTime klasę: ToBinary Metoda jest używana do kodowania DateTime wartości, a FromBinary metoda dekoduje wartość. Zapoznaj się z dokumentacją tych metod, aby uzyskać korekty, które mogą zostać wprowadzone w celu dekodowania wartości, gdy DateTime element jest przechowywany, który nie jest wartością uniwersalnego czasu koordynowanego (UTC).

Specyfika implementacji platformy

Wszystkie dane są przechowywane w preferencjach udostępnionych. Jeśli nie sharedName określono domyślnych preferencji udostępnionych, w przeciwnym razie nazwa jest używana do pobierania prywatnych preferencji udostępnionych o określonej nazwie.

Trwałość

Odinstalowanie aplikacji spowoduje usunięcie wszystkich preferencji, z wyjątkiem są aplikacje docelowe i uruchamiane w systemie Android 6.0 (poziom interfejsu API 23) lub nowszym, które korzystają z automatycznej kopii zapasowej. Ta funkcja jest domyślnie włączona i zachowuje dane aplikacji, w tym preferencje udostępnione, co jest używane przez interfejs API preferencji . Możesz to wyłączyć, postępując zgodnie z dokumentacją firmy Google.

Ograniczenia

Podczas przechowywania ciągu ten interfejs API jest przeznaczony do przechowywania małych ilości tekstu. Wydajność może być podrzędna, jeśli spróbujesz użyć jej do przechowywania dużych ilości tekstu.

interfejs API

Więcej filmów na platformie Xamarin można znaleźć w witrynach Channel 9 i YouTube.