FrameworkElement.Language Property

Ruft Lokalisierungs-/Globalisierungsspracheninformationen ab, die auf ein FrameworkElement und auf alle untergeordneten Elemente im aktuellen FrameworkElement der Objektdarstellung sowie auf die Benutzeroberfläche angewendet werden, oder legt diese fest.

Syntax


public string Language { get; set; }


<frameworkElement Language="languageString" .../.

XAML Values

languageString

Eine Zeichenfolge, die die Sprache und Kultur angibt, die den IETF BCP 47-Standards folgen. Beispielsweise wird für Englisch (USA) "en-US" verwendet.

Eigenschaftswert

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

Eine Zeichenfolge, die Sprache und Kultur in einer Form angibt, die dem BCP 47-Standard der IETF (Internet Engineering Task Force) folgt. Beispielsweise wird für Englisch (USA) "en-US" verwendet.

Hinweise

Die Language-Eigenschaft ist zum Festlegen einer Spracheinstellung pro Element auf ausgewählten Elementen in einer größeren UI vorgesehen. Der Hauptgrund für diese Vorgehensweise ist, textbezogene Eigenschaften und Einstellungen zu beeinflussen, z. B. was die Standard- oder Fallback-FontFamily für die Textdarstellung sein sollte.

Die Language-Eigenschaft ist hauptsächlich für diese FrameworkElement-Unterklassen relevant:

Die TextElement-Klasse verfügt auch über eine Language-Eigenschaft und hat einen ähnlichen Zweck und ein ähnliches Verhalten für TextElement-Unterklassen, wie Run.

Wenn es nicht ausdrücklich als Attribut festgelegt ist, wird der Standardwert für Language durch andere, größere Faktoren bestimmt, die sich auf die Globalisierungs- und Lokalisierungseinstellungen für Ihre App auswirken. Dies schließt die Systemeinstellungen des Benutzers ein. Weitere Informationen finden Sie unter Globalisieren der App.

Durch Festlegen von Language für UI-Elemente können Sie einen kleinen Teil zur Vorbereitung einer App für die Lokalisierung und Globalisierung beitragen. Beispielsweise müssen Sie in der Regel Ressourcen wie Zeichenfolgen und Bilder benennen oder laden und diese Ressourcen in das App-Paket einschließen. Sie müssen außerdem x:Uid-Werte für alle Elemente anwenden, die Ressourcenqualifizierer verwenden sollten, um die sprachspezifische Ressource abzurufen. Weitere Informationen finden Sie unter Globalisieren der App.

Wenn Sie die Language im Markup festlegen, sollten Sie die Verwendung einer RESW-Ressourcendatei in Erwägung ziehen, um die Zeichenfolge "BCPS 47" anzugeben, anstatt eine Zeichenfolge im Markup fest zu codieren. Geben Sie einen x:Uid-Wert für das Element an, in dem Sie Language angeben möchten, damit das Ressourcensystem auf das Element angewendet werden kann. Erstellen Sie dann eine Zeichenfolgenressource der Zeichenfolge BCPS 47, die dem Ressourcenordnernamen entspricht, aus dem die Ressource stammt. Sie haben wahrscheinlich bereits eine RESW-Datei im Projekt, das die lokalisierten konventionellen Benutzeroberflächen-Zeichenfolgen bereitstellt. Weitere Informationen finden Sie unter Schnellstart: Übersetzen von Benutzeroberflächen.

FrameworkElement.Language und xml:lang

XAML ist eine Sprache, die auf XML basiert und grundlegenden XML-Regeln folgt. Dies schließt die Unterstützung von XML-Konstrukten, wie das lang-Attribut vom XML-Sprache-XML-Namespace, ein. Sie können xml:lang für ein Objektelement für eine FrameworkElement-Unterklasse angeben, und es wird genauso behandelt wie ein Language-Wert, da es dieselbe BCPS 47-Behandlung des Zeichenfolgenattributwerts verwendet. Sie können xml:lang für ein Objektelement auch angeben, das keine FrameworkElement-Unterklasse ist, obwohl das in der Regel nicht zu einer Verhaltensänderung dieses Elements führt.

Language verwendet absichtlich eine Eigenschaftenvererbungsstruktur, damit ein Wert für Language, der auf dem Stammelement festgelegt wird, in der visuellen Struktur an alle untergeordneten Objekte, die auch ein FrameworkElement sind, weitergegeben wird. Dies entspricht dem xml:lang-Verhalten in XML und XML DOM. Außerdem können Sie Language zur Laufzeit verwenden, um einen xml:lang-Wert zu lesen, der im Markup festgelegt wurde, solange das Element, dass Sie lesen, eine FrameworkElement-Unterklasse ist, die über eine Language-Eigenschaft verfügt.

Sie können aber nicht sowohl das Language- als auch das xml:lang-Attribut auf dasselbe Objektelement angeben, das einen XAML-Analysefehler auslöst.

Migrationshinweise

Diese API verwendet eine Zeichenfolge. In der entsprechenden Microsoft Silverlight- und Windows Presentation Foundation (WPF)-API ist der Typ dieser Eigenschaft ein Hilfsobjekt, das dieselbe Zeichenfolge umschließt. Sie können XAML aus anderen Projekten importieren, ohne diesen Unterschied zu bemerken, da die auf der Zeichenfolge basierende XAML-Analyse identisch ist.

Anforderungen

Mindestens unterstützter Client

Windows 8

Mindestens unterstützter Server

Windows Server 2012

Namespace

Windows.UI.Xaml
Windows::UI::Xaml [C++]

Metadaten

Windows.winmd

Siehe auch

FrameworkElement
Globalisieren der App
FlowDirection
IANA-Liste von Sprachen
x:Uid

 

 

Anzeigen:
© 2015 Microsoft