ApplicationLanguages Klasse

Referenz

Definition

Namespace:: Windows.Globalization

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.

Bearbeiten

Gibt die sprachbezogenen Einstellungen an, die die App verwenden und verwalten kann.

public ref class ApplicationLanguages abstract sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ApplicationLanguages final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public static class ApplicationLanguages

Public Class ApplicationLanguages

Vererbung: Object Platform::Object IInspectable ApplicationLanguages

Attribute: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Die Sprachen, auf die in dieser Klasse verwiesen wird, werden durch BCP-47-Sprachtags dargestellt. Jede davon ist ein Sprachbezeichner und kein Gebietsschemaname, obwohl die beiden strukturell identisch sein können. Als Sprachtag bedeutet "en-US" amerikanisches Englisch (oder der Dialekt des Englischen, der im USA gesprochen wird). Es macht keine Ansprüche über den tatsächlichen Standort der Sprecher (obwohl sich viele von ihnen in den USA befinden) und keine anderen Ansprüche über Konventionen, die in den USA wie das Messsystem oder die Währung verwendet werden.

Beispiel:

Windows.Globalization.ApplicationLanguages.PrimaryLanguageOverride = "en-US"

Hinweis

Wenn Ihre App Sprachtags von dieser Klasse an Alle Funktionen zur Unterstützung nationaler Sprachen übergibt, muss sie zuerst die Tags konvertieren, indem ResolveLocaleName aufgerufen wird.

Sprachtags unterstützen die Unicode-Erweiterungen "ca-" und "nu-". (Siehe Unicode-Schlüssel-/Typdefinitionen.) Beachten Sie, dass sich diese Erweiterungen auf das von Globalisierungsobjekten verwendete Zahlensystem oder Kalender auswirken können.

UWP-Apps können mithilfe von Ressourcenpaketen bereitgestellt werden. Wenn Sprachressourcenpakete verwendet werden, werden die Pakete, die für einen bestimmten Benutzer installiert und registriert sind, durch die Sprachen im Sprachprofil des Benutzers bestimmt. Daher sind nicht alle Sprachen, die im App-Bündel enthalten sind, das an den Microsoft Store übermittelt wurde, notwendigerweise zur Laufzeit 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 zur Verwendung als ApplicationLanguages-Objekt zur Laufzeit verfügbar sind, sind auf die Sprachen beschränkt, die im Standard App-Paketmanifest enthalten sind, und auf die Sprachen, die sprachressourcenpaketen entsprechen, die für den Benutzer anwendbar sind (bestimmt durch übereinstimmende Sprachen in den Benutzereinstellungen), die für den Benutzer installiert und registriert sind. Die ApplicationLanguages.ManifestLanguages-Eigenschaft spiegelt Sprachressourcenpakete wider, die für den Benutzer verfügbar sind, und gibt einen geeigneten 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 ManifestLanguages-Eigenschaft sehr ähnlich ist. Es kann sich unterscheiden, wenn regionale Sprachvariationen eingeschlossen werden, die in keinem Paketmanifest aufgeführt sind. Beispielsweise kann "en-CA" (Englisch (Kanada)) von der Languages-Eigenschaft zurückgegeben werden, wenn der Benutzer "en-CA" in ihrem Profil hat und die App eine regionale Vielfalt von Englisch unterstützt. Solche vom Benutzer abgeleiteten regionalen Sprachvariationen können für das Festlegen der PrimaryLanguageOverride-Eigenschaft vorzuziehen sein, da die App dann für den Benutzer geeignete Globalisierungsverhalten bereitstellt.

Wenn eine Sprache im Standard App-Paket enthalten ist, aber keine Übereinstimmung mit einer Sprache in der bevorzugten Sprache des Benutzers ist, 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 sich diese Sprachen jedoch nicht in den Einstellungen des Benutzers widerspiegeln, versteht der Benutzer diese Sprachen möglicherweise nicht. Solche Einstellungen sollten nur verwendet werden, wenn sie vom Benutzer direkt ausgewählt werden.

Versionsverlauf

Windows-Version	SDK-Version	Mehrwert
1803	17134	GetLanguagesForUser

Eigenschaften

Languages	Ruft eine sortierte Liste der aktuellen Laufzeitsprachwerte ab, die vom Benutzer bevorzugt werden.
ManifestLanguages	Ruft die deklarierte Liste der unterstützten Sprachen der App ab.
PrimaryLanguageOverride	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.

Methoden

GetLanguagesForUser(User)

Ruft die Spracheinstellungen des angegebenen Benutzers ab. Diese API ist Teil der Unterstützung für Multi-User-Apps (MUA).

Gilt für:

Freigeben über