ApplicationLanguages.PrimaryLanguageOverride Propriedade

Definição

Namespace:

Windows.Globalization

Obtém ou define uma substituição para o idioma preferido do aplicativo, expresso como uma marca de idioma BCP-47 . Essa configuração é persistente.

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

Valor da propriedade

String

Platform::String

winrt::hstring

Uma marca de idioma BCP-47 . O aplicativo pode defini-lo para substituir o idioma superior da lista classificada do usuário de idiomas preferenciais (ApplicationLanguages.Languages) e seu valor persistirá entre as sessões de aplicativo. Deve ser uma marca de idioma único; uma lista delimitada de marcas de idioma falhará.

Quando seu aplicativo obtém o valor, PrimaryLanguageOverride retorna uma única marca de idioma (se o aplicativo tiver definido anteriormente a propriedade) ou uma cadeia de caracteres vazia.

Comentários

Normalmente, os aplicativos são executados com configurações de idioma determinadas pelo sistema comparando os idiomas compatíveis com o aplicativo com as preferências de idioma do usuário. As configurações para esse comportamento do sistema podem ser obtidas usando a propriedade ApplicationLanguages.Languages . A propriedade PrimaryLanguageOverride é usada para substituir esse comportamento definindo um idioma específico como o primeiro idioma na lista Idiomas.

A configuração PrimaryLanguageOverride é persistente entre as sessões. Ele não deve ser definido sempre que o aplicativo é carregado. Ele só deve ser definido com base na entrada do usuário apresentada na interface do usuário das configurações. A propriedade pode ser lida a qualquer momento. Se a propriedade nunca tiver sido definida, ela retornará uma cadeia de caracteres vazia.

Quando você define PrimaryLanguageOverride, isso é refletido imediatamente na propriedade ApplicationLanguages.Languages . No entanto, essa alteração pode não entrar em vigor imediatamente nos recursos carregados na interface do usuário do aplicativo. Para garantir que o aplicativo responda a essas alterações, você pode ouvir a propriedade QualifierValues em um contexto de recurso padrão e executar todas as ações necessárias para recarregar recursos. Esses requisitos podem variar dependendo da estrutura de interface do usuário usada pelo aplicativo e pode ser necessário reiniciar o aplicativo.

Confira também

• Languages
• Marcas de idioma BCP-47