ApplicationLanguages.PrimaryLanguageOverride Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft eine Außerkraftsetzung für die bevorzugte Sprache der App ab, ausgedrückt als BCP-47-Sprachtag , oder legt diese fest. Diese Einstellung wird beibehalten.
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 StringEigenschaftswert
Ein BCP-47-Sprachtag . Die App kann festlegen, dass die oberste Sprache der liste der bevorzugten Sprachen des Benutzers (ApplicationLanguages.Languages) überschrieben wird, und ihr Wert wird zwischen App-Sitzungen beibehalten. Es muss sich um ein einziges Sprachtag sein. Eine durch Trennzeichen getrennte Liste von Sprachtags schlägt fehl.
Wenn Ihre App den Wert abruft, gibt PrimaryLanguageOverride entweder ein einzelnes Sprachtag (wenn Ihre App zuvor die -Eigenschaft festgelegt hat) oder eine leere Zeichenfolge zurück.
Hinweise
Apps werden normalerweise mit Spracheinstellungen ausgeführt, die vom System festgelegt werden, indem die von der App unterstützten Sprachen mit den Spracheinstellungen des Benutzers verglichen werden. Die Einstellungen für dieses Systemverhalten können mithilfe der ApplicationLanguages.Languages-Eigenschaft abgerufen werden. Die PrimaryLanguageOverride-Eigenschaft wird verwendet, um dieses Verhalten zu überschreiben, indem eine bestimmte Sprache als erste Sprache in der Liste Sprachen festgelegt wird.
Die PrimaryLanguageOverride-Einstellung wird zwischen Sitzungen beibehalten. Sie sollte nicht jedes Mal festgelegt werden, wenn die App geladen wird. Sie sollte nur basierend auf Benutzereingaben festgelegt werden, die in der Benutzeroberfläche für Einstellungen angezeigt werden. Die -Eigenschaft kann jederzeit gelesen werden. Wenn die Eigenschaft noch nie festgelegt wurde, wird eine leere Zeichenfolge zurückgegeben.
Wenn Sie primaryLanguageOverride festlegen, wird dies sofort in der ApplicationLanguages.Languages-Eigenschaft angezeigt. Diese Änderung wird jedoch möglicherweise nicht sofort auf Ressourcen wirksam, die in der App-Benutzeroberfläche geladen werden. Um sicherzustellen, dass die App auf solche Änderungen reagiert, können Sie auf die QualifierValues-Eigenschaft in einem Standardressourcenkontext lauschen und alle aktionen ausführen, die zum Erneutladen von Ressourcen erforderlich sind. Diese Anforderungen können je nach von der App verwendeten Benutzeroberflächenframework variieren, und es kann erforderlich sein, die App neu zu starten.