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 сохраняется между сеансами. Его не следует задавать при каждой загрузке приложения. Его следует задавать только на основе введенных пользователем данных, представленных в пользовательском интерфейсе параметров. Свойство может быть прочитано в любое время. Если свойство никогда не было задано, возвращается пустая строка.

При установке Параметра PrimaryLanguageOverride это сразу же отражается в свойстве ApplicationLanguages.Languages . Однако это изменение может не сразу ввести в силу ресурсы, загруженные в пользовательском интерфейсе приложения. Чтобы убедиться, что приложение реагирует на такие изменения, можно прослушивать свойство QualifierValues в контексте ресурса по умолчанию и выполнять любые действия, которые могут потребоваться для перезагрузки ресурсов. Эти требования могут отличаться в зависимости от платформы пользовательского интерфейса, используемой приложением, и может потребоваться перезапустить приложение.

Применяется к

См. также раздел