| title | ms.custom | ms.date | ms.prod | ms.reviewer | ms.suite | ms.technology | ms.tgt_pltfrm | ms.topic | helpviewer_keywords | ms.assetid | caps.latest.revision | author | ms.author | manager | |||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
xml:lang Handling in XAML |
03/30/2017 |
.net-framework |
|
article |
|
7aac0078-a1c5-41f8-b8b0-975510d9dca0 |
16 |
wadepickett |
wpickett |
wpickett |
xml:lang Handling in XAML
The xml:lang attribute is an [!INCLUDETLA2#tla_xml]-defined attribute that declares the language and culture information for an element in XML. This same meaning of the attribute persists in XAML; however, some additional considerations apply.
XAML Attribute Usage
<object xml:lang="rfc3066lang" /> XAML Values
| rfc3066lang | A string that is derived from the RFC 3066 standard and identifies either a language or a language-region. When it is the latter, the language and region are separated by a single hyphen. See xref:System.Windows.Markup.XmlLanguage for more information about the values and format. |
Remarks
The definition for the xml:lang attribute in [!INCLUDETLA2#tla_xaml] is derived from xml:lang as defined as a "special attribute" by the [!INCLUDETLA#tla_w3c] for [!INCLUDETLA2#tla_xml]. Language and culture information is potentially processed in different ways by elements, depending on their implementations; however, there is no default [!INCLUDETLA2#tla_xaml] processing of the xml:lang attribute.
The default value of the xml:lang attribute is an empty string at the attribute level.
The xml:lang attribute effects and the value of the attribute are generally perpetuated to child elements, when interpreted by systems that act on xml:lang values.
When interpreted by XAML writers of .NET Framework XAML Services, an xml:lang value can create xref:System.Windows.Markup.XmlLanguage or xref:System.Globalization.CultureInfo objects in the underlying object representation; however, that behavior depends on whether the value specified for xml:lang is a valid construction for those classes.
Frameworks can create associations between framework-defined properties and the meaning of xml:lang in XML by applying xref:System.Windows.Markup.XmlLangPropertyAttribute to the property.
WPF Usage Nodes
For elements that are derived classes of xref:System.Windows.FrameworkElement or xref:System.Windows.FrameworkContentElement, you can use the equivalent xref:System.Windows.FrameworkElement.Language%2A dependency property instead of the xml:lang attribute. By default, the xref:System.Windows.FrameworkElement.Language%2A property uses "en-US" if it is not otherwise set, either through the property or through processing the xml:lang attribute.