다음을 통해 공유


ApplicationLanguages.PrimaryLanguageOverride 속성

정의

BCP-47 언어 태그로 표현된 앱의 기본 설정 언어에 대한 재정의를 가져오거나 설정합니다. 이 설정은 유지됩니다.

public:
 static property Platform::String ^ PrimaryLanguageOverride { Platform::String ^ get(); void set(Platform::String ^ value); };
static winrt::hstring PrimaryLanguageOverride();

static void PrimaryLanguageOverride(winrt::hstring value);
public static string PrimaryLanguageOverride { get; set; }
var string = ApplicationLanguages.primaryLanguageOverride;
ApplicationLanguages.primaryLanguageOverride = string;
Public Shared Property PrimaryLanguageOverride As String

속성 값

String

Platform::String

winrt::hstring

BCP-47 언어 태그입니다. 앱은 사용자의 순위가 지정된 기본 언어 목록(ApplicationLanguages.Languages)의 최상위 언어를 재정의하도록 설정할 수 있으며 해당 값은 앱 세션 간에 유지됩니다. 단일 언어 태그여야 합니다. 구분된 언어 태그 목록이 실패합니다.

앱이 값을 가져오면 PrimaryLanguageOverride는 단일 언어 태그(앱에서 이전에 속성을 설정한 경우) 또는 빈 문자열을 반환합니다.

설명

앱은 일반적으로 앱에서 지원하는 언어와 사용자의 언어 기본 설정을 비교하여 시스템에서 결정한 언어 설정으로 실행됩니다. 해당 시스템 동작에 대한 설정은 ApplicationLanguages.Languages 속성을 사용하여 가져올 수 있습니다. PrimaryLanguageOverride 속성은 특정 언어를 언어 목록에서 첫 번째 언어로 설정하여 해당 동작을 재정의하는 데 사용됩니다.

PrimaryLanguageOverride 설정은 세션 간에 유지됩니다. 앱이 로드될 때마다 설정해서는 안 됩니다. 설정 UI에 표시되는 사용자 입력에 따라 설정해야 합니다. 속성은 언제든지 읽을 수 있습니다. 속성이 설정되지 않은 경우 빈 문자열을 반환합니다.

PrimaryLanguageOverride를 설정하면 ApplicationLanguages.Languages 속성에 즉시 반영됩니다. 그러나 이 변경 내용은 앱 UI에 로드된 리소스에 즉시 적용되지 않을 수 있습니다. 앱이 이러한 변경 내용에 응답하도록 하려면 기본 리소스 컨텍스트에서 QualifierValues 속성을 수신 대기하고 리소스를 다시 로드하는 데 필요한 작업을 수행할 수 있습니다. 이러한 요구 사항은 앱에서 사용하는 UI 프레임워크에 따라 달라질 수 있으며 앱을 다시 시작해야 할 수도 있습니다.

적용 대상

추가 정보