ApplicationLanguages.PrimaryLanguageOverride | primaryLanguageOverride Property

Ruft eine Überschreibung für die bevorzugte Sprache der App ab oder legt diese fest, die als ein BCP-47-Sprach-Tag ausgedrückt wird. Diese Einstellung ist persistent.

Syntax


public:
static property String^ PrimaryLanguageOverride { 
   String^ get();
   void set (String^ value);
}

Eigenschaftswert

Typ: String [JavaScript] | System.String [.NET] | Platform::String [C++]

Ein BCP-47-Sprachtag. Die App kann festlegen, dass in der Liste der vom Benutzer bevorzugten Sprachen (ApplicationLanguages.Languages) die an oberster Stelle aufgeführte Sprache von diesem Tag überschrieben wird und der Wert des Tags zwischen den App-Sitzungen beibehalten wird. Sie muss ein einzelnes Sprachtag aufweisen; eine getrennte Liste von Sprachtags schlägt fehl.

Wenn Ihre App den Wert abruft, gibt PrimaryLanguageOverride entweder einen einzelnen Sprachtag (wenn die App zuvor die Eigenschaft festgelegt hat) oder eine leere Zeichenfolge zurück.

Hinweise

Apps werden normalerweise mit den Spracheinstellungen ausgeführt, die das System bestimmt, indem die von der App unterstützten Sprachen mit den Spracheinstellungen des Benutzers verglichen werden. Die Einstellungen für dieses Systemverhalten können mit 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 Sprachenliste festgelegt wird.

Die PrimaryLanguageOverride-Einstellung wird zwischen den Sitzungen beibehalten. Es sollte nicht bei jedem Laden der App festgelegt werden. Sie muss auf Grundlage der Benutzereingabe festgelegt werden, die in der Einstellungs-UI dargestellt wird. 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 übernommen. Allerdings wird diese Änderung möglicherweise nicht sofort bei den 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 erforderlichen Aktionen zum erneuten Laden von Ressourcen durchführen. Diese Anforderungen können je nach Benutzeroberflächenframework variieren, das von der Anwendung verwendet wird, und die App muss möglicherweise neu gestartet werden.

Hinweis  Wenn die App Sprachtags von dieser Klasse an National Language Support-Funktionen übergibt, müssen die Tags zuvor durch den Aufruf von ResolveLocaleName konvertiert werden.

Ab Windows 8.1:

Sprachtags können Unicode-Erweiterungen unterstützen. Weitere Informationen finden Sie in den Hinweisen zur ApplicationLanguages-Klasse.

Windows Store-Apps können mithilfe von Ressourcenpaketen bereitgestellt werden. Bei Verwendung von Sprachressourcenpaketen werden die Pakete, die für einen bestimmten Benutzer installiert und registriert sind, anhand der Sprachen im Sprachenprofil des Benutzers ermittelt. Folglich sind nicht alle im App-Bundle enthaltenen Sprachen, der an den Windows Store übermittelt wurde, für die Verwendung zur Laufzeit unbedingt verfügbar. Die PrimaryLanguageOverride-Eigenschaft sollte nur auf Sprachen festgelegt werden, die für den Benutzer verfügbar sind.

Die Sprachen, die für die App als ApplicationLanguages-Objekt zur Laufzeit verfügbar sind, sind auf die Sprachen beschränkt, die im Haupt-App-Paketmanifest enthalten sind, und auf die Sprachen, die Sprachressourcenpaketen entsprechen, die für den Benutzer gelten (bestimmt durch das Vergleichen der Sprachen in den Einstellungen des Benutzers) und für diesen installiert und registriert sind. Die ApplicationLanguages.ManifestLanguages-Eigenschaft spiegelt Sprachressourcenpacks wider, die für den Benutzer verfügbar sind, und gibt somit einem entsprechenden Satz von Sprachen zurück, die zum Festlegen der PrimaryLanguageOverride-Eigenschaft verwendet werden können.

Die ApplicationLanguages.Languages-Eigenschaft gibt eine Liste zurück, die der von der ManifestLanguages-Eigenschaft zurückgegebenen Liste sehr ähnlich ist. Sie unterscheidet sich möglicherweise dadurch, dass sie Regionalsprachenvariationen, die nicht in jedem Paketmanifest aufgeführt sind, umfasst. Beispielsweise kann "en-CA" (Englisch (Kanada)) von der Languages-Eigenschaft zurückgegeben werden, wenn der Benutzer über "EN-CA" in seinem Profil verfügt und die App regionale Variationen der englischen Sprache unterstützt. Solche vom Benutzer abgeleiteten regionalen Sprachvarianten können zum Festlegen der PrimaryLanguageOverride-Eigenschaft besser sein, da die App dann Globalisierungsverhalten bereitstellt, das für den Benutzer besser geeignet ist.

Wenn sich eine Sprache im Haupt-App-Paket befindet, sie aber mit keiner Sprache in der Einstellung des Benutzers übereinstimmt, wird sie von der ManifestLanguages-Eigenschaft zurückgegeben, aber nicht von der Languages-Eigenschaft. Diese können auch zum Festlegen der PrimaryLanguageOverride-Eigenschaft verwendet werden. Da diese Sprachen nicht in den Einstellungen des Benutzers übernommen werden, versteht der Benutzer möglicherweise diese Sprachen nicht. Diese Einstellungen sollten nur verwendet werden, wenn sie direkt vom Benutzer ausgewählt werden.

Anforderungen

Mindestens unterstützter Client

Windows 8

Mindestens unterstützter Server

Windows Server 2012

Namespace

Windows.Globalization
Windows::Globalization [C++]

Metadaten

Windows.winmd

Siehe auch

ApplicationLanguages
ApplicationLanguages.Languages
BCP-47-Sprachtags

 

 

Anzeigen:
© 2014 Microsoft