ApplicationLanguages.PrimaryLanguageOverride Propriété

Définition

Obtient ou définit une substitution pour la langue préférée de l’application, exprimée sous la forme d’une balise de langue BCP-47 . Ce paramètre est conservé.

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

Valeur de propriété

String

Platform::String

winrt::hstring

Balise de langue BCP-47 . L’application peut la définir pour remplacer la langue supérieure de la liste classée des langues préférées de l’utilisateur (ApplicationLanguages.Languages), et sa valeur persiste entre les sessions d’application. Il doit s’agir d’une balise de langue unique ; une liste délimitée de balises de langue échoue.

Lorsque votre application obtient la valeur, PrimaryLanguageOverride retourne une seule balise de langue (si votre application a précédemment défini la propriété) ou une chaîne vide.

Remarques

Les applications s’exécutent normalement avec des paramètres de langue déterminés par le système en comparant les langues prises en charge par l’application avec les préférences linguistiques de l’utilisateur. Les paramètres de ce comportement système peuvent être obtenus à l’aide de la propriété ApplicationLanguages.Languages . La propriété PrimaryLanguageOverride est utilisée pour remplacer ce comportement en définissant une langue spécifique comme première langue dans la liste Langues.

Le paramètre PrimaryLanguageOverride est conservé entre les sessions. Il ne doit pas être défini chaque fois que l’application est chargée. Il doit être défini uniquement en fonction de l’entrée utilisateur présentée dans l’interface utilisateur des paramètres. La propriété peut être lue à tout moment. Si la propriété n’a jamais été définie, elle retourne une chaîne vide.

Lorsque vous définissez PrimaryLanguageOverride, cela se reflète immédiatement dans la propriété ApplicationLanguages.Languages . Toutefois, cette modification peut ne pas prendre effet immédiatement sur les ressources chargées dans l’interface utilisateur de l’application. Pour vous assurer que l’application répond à ces modifications, vous pouvez écouter la propriété QualifierValues sur un contexte de ressource par défaut et prendre toutes les actions nécessaires pour recharger les ressources. Ces exigences peuvent varier en fonction de l’infrastructure d’interface utilisateur utilisée par l’application, et il peut être nécessaire de redémarrer l’application.

S’applique à

Voir aussi