ApplicationLanguages Klasse

Definition

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

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"

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

Eigenschaften

Methoden

Gilt für:

Weitere Informationen

• BCP-47-Sprachtags
• Unicode-Schlüssel-/Typdefinitionen