ApplicationLanguages.PrimaryLanguageOverride Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
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
Значение свойства
Одно, предпочтительное переопределение языка поддерживаемой коллекции языков, возвращаемой языками, выраженная как тег языка BCP-47.
Замечание
Это должен быть один тег языка. Если используется разделенный список тегов языка или какое-либо значение, не представляющее тег языка, создается исключение.
Когда приложение получает значение, PrimaryLanguageOverride возвращает либо один языковой тег (если приложение ранее задало свойство) или пустую строку.
Примеры
В следующем примере показано, как задать переопределение de-DEосновного языка, в результате чего приложение использует ресурсы германии (Германия). Ресурсы, загруженные вручную с помощью ResourceLoader и ресурсов XAML, извлекаемых с помощью x:Uid, будут немецкими (Германия).
public partial class App : Application
{
// ...
public App()
{
Microsoft.Windows.Globalization.ApplicationLanguages.PrimaryLanguageOverride = "de-DE";
var resourceLoader = new Microsoft.Windows.ApplicationModel.Resources.ResourceLoader();
var resourceString = resourceLoader.GetString("SampleString");
this.InitializeComponent();
}
// ...
}
Комментарии
Для упакованных приложений это свойство является оболочкой для Windows. Globalization.ApplicationLanguages.PrimaryLanguageOverride свойство и ведет себя аналогично.
Это свойство должно быть задано только для языков, доступных приложению. Для упакованных приложений языки, доступные приложению, ограничены этими языками, включенными в манифест основного пакета приложения. Свойство ManifestLanguages отражает пакеты языковых ресурсов, доступные пользователю, и возвращает соответствующую коллекцию языков, которые можно использовать для задания значения PrimaryLanguageOverride . Для распакованных приложений языки, доступные для использования приложения, ограничены языками, для которых ваше приложение явно объявило поддержку.
Этот параметр является глобальным для выполняемого процесса.
Если это упаковаемое приложение, параметр сохраняется между сеансами приложений. В противном случае оно не сохраняется между сеансами приложений и должно быть установлено при каждой загрузке приложения.
Задайте параметр PrimaryLanguageOverride во время загрузки приложения перед загрузкой любого ресурса.
Если свойство никогда не было задано, он возвращает пустую строку.
При установке primaryLanguageOverride он будет отражен в любых ресурсах, загруженных после. Однако для ресурсов, уже загруженных в пользовательском интерфейсе приложения, это изменение может не вдействовать немедленно. Чтобы приложение ответило на эти изменения, может потребоваться перезагрузить ресурсы (это может отличаться от платформы пользовательского интерфейса и может потребовать перезапуска приложения).