Permalink
Fetching contributors…
Cannot retrieve contributors at this time
54 lines (42 sloc) 3.27 KB
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
dotnet-wpf
article
XAML [XAML Services], xml:lang attribute
xml:lang attribute [XAML Services]
RFC 3066 standard [XAML Services]
standards [XAML Services], RFC 3066
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.

See Also

Globalization for WPF