Xamarin.Essentials기본 설정
Preferences 클래스를 사용하여 키/값 저장소에 애플리케이션 기본 설정을 저장할 수 있습니다.
시작하기
이 API를 사용하기 전에 라이브러리가 제대로 설치되고 프로젝트에 설정되어 있는지 확인하기 위해 Xamarin.Essentials에 대한 시작 가이드를 읽어보세요.
기본 설정 사용
클래스에서 Xamarin.Essentials에 대한 참조를 추가합니다.
using Xamarin.Essentials;
기본 설정에서 지정된 ‘키’의 값을 저장합니다.
Preferences.Set("my_key", "my_value");
기본 설정에서 값을 검색하거나 설정되지 않은 경우 기본값을 검색합니다.
var myValue = Preferences.Get("my_key", "default_value");
지정된 ‘키’가 기본 설정에 있는지 확인하려면 다음을 수행합니다.
bool hasKey = Preferences.ContainsKey("my_key");
기본 설정에서 ‘키’를 제거합니다.
Preferences.Remove("my_key");
모든 기본 설정을 제거합니다.
Preferences.Clear();
팁
위의 메서드는 sharedName이라는 선택적 string 매개 변수를 사용합니다. 이 매개 변수는 일부 사용 사례에서 유용한 기본 설정에 대한 추가 컨테이너를 만드는 데 사용됩니다. 한 가지 사용 사례는 애플리케이션이 확장 또는 조사식 애플리케이션에서 기본 설정을 공유해야 하는 경우입니다. 아래의 플랫폼 구현 관련 정보를 참조하세요.
지원되는 데이터 형식
다음 데이터 형식은 기본 설정에서 지원됩니다.
- 부울
- double
- int
- float
- long
- string
- DateTime
시스템 설정과 통합
기본 설정은 기본적으로 저장되므로 설정을 네이티브 시스템 설정에 통합할 수 있습니다. 플랫폼 설명서 및 샘플을 따라 플랫폼과 통합합니다.
- Apple: iOS 설정 번들 구현
- iOS 애플리케이션 기본 설정 샘플
- watchOS 설정
- Android: 설정 화면 시작
구현 세부 정보
DateTime 값은 DateTime 클래스에서 정의한 두 가지 메서드를 사용하여 64비트 이진(long 정수) 형식으로 저장됩니다. ToBinary 메서드는 DateTime 값을 인코드하는 데 사용되고 FromBinary 메서드는 값을 디코드합니다. UTC(협정 세계시) 값이 아닌 DateTime이 저장될 때 디코드된 값으로 설정할 수 있는 조정에 대해서는 이러한 메서드의 문서를 참조하세요.
플랫폼 구현 관련 정보
모든 데이터는 공유 기본 설정에 저장됩니다. sharedName을 지정하지 않으면 기본 공유 기본 설정이 사용되고, 지정한 경우에는 해당 이름을 사용하여 프라이빗 공유 기본 설정을 가져오는 데 이름이 사용됩니다.
지속성
애플리케이션을 제거하면 모든 기본 설정이 제거되나, 자동 백업을 사용하는 Android 6.0(API 수준 23) 이상을 대상으로 하여 실행되는 앱은 예외입니다. 이 기능은 기본적으로 켜지고 기본 설정 API에서 사용하는 공유 기본 설정을 포함한 앱 데이터를 유지합니다. 다음 Google의 문서를 사용하여 이 기능을 사용하지 않도록 설정할 수 있습니다.
제한 사항
문자열을 저장할 때 이 API는 소량 텍스트를 저장하기 위한 것입니다. 대량 텍스트를 저장하는 데 사용하려고 하면 성능이 저하될 수 있습니다.