Share via


Cultures Generated from Windows Locales

Globalization support in the .NET Framework automatically creates a culture that corresponds to a Windows locale, if such a culture does not exist in the .NET Framework.

Generated Cultures

Windows ships with a set of locales, equivalent to .NET Framework cultures, that specify culture-specific information such as how text is sorted, how a date is formatted, and the display format of numbers and currency. Windows also supports a feature called the Enabled Languages Kit (ELK) that enables the addition of new locales without requiring a new operating system release. As a result, your application can add a locale to Windows that does not correspond to a culture in the .NET Framework.

If your application tries to create a CultureInfo object for a culture that does not exist in the .NET Framework, and a corresponding locale exists in Windows, the .NET Framework automatically creates a new culture based on the Windows locale. The new culture is created when the application specifies its name or identifier, and can be used like any other .NET Framework culture.

The name of a generated culture consists of its ISO 639 language code, ISO 3166 country/region code, and an optional ISO 15924 script tag for the written language. For example, the name of the culture using the Bosnian language, as used in Bosnia and Herzegovina and written in Latin script, is bs-Latn-BA. A complete table of supported cultures with names and identifiers is found on the NLS information page at the Go Global Developer Center (https://msdn.microsoft.com/en-us/goglobal/bb896001.aspx.

Performance Considerations

A culture generated from a Windows locale is created the first time the CultureInfo constructor is called for that culture, and the creation process is time-consuming. However, subsequent culture objects are created without a performance penalty.

Serializing and deserializing a culture is the process of creating a binary representation of a CultureInfo object, then using that binary representation to reconstitute the original CultureInfo object. Your application can serialize a culture on one computer and deserialize it on another. However, if the application serializes a culture derived from an ELK locale on one computer, an exception is thrown if the application deserializes the binary representation on another computer that does not have the same ELK locale installed.

Default Values

Data from a Windows locale is used to populate the corresponding property of a CultureInfo object created from that locale. If there is no corresponding locale data, the property is populated with a default value.

The return value of many CultureInfo methods and some properties depends on culture-specific data. If the Windows locale does not provide culture-specific data for the generated culture, data is derived from a default culture. In most cases, the default culture is the invariant culture.

The following table lists the default value for the properties, and the default culture for the methods, of the CultureInfo, RegionInfo, NumberFormatInfo, CompareInfo, TextInfo, and Calendar classes that support a .NET Framework culture.

CultureInfo

Member

Default

IsNeutralCulture

false, because Windows does not have neutral cultures.

Parent

Invariant culture, because Windows does not have neutral cultures.

GetConsoleFallbackUICulture

Invariant culture.

RegionInfo

Member

Default

GeoId

Zero for Windows 2000; inherited from Windows XP and later.

DateTimeFormatInfo

Member

Default

GetAbbreviatedEraName

Invariant culture.

GetEra

Invariant culture.

GetEraName

Invariant culture.

MonthDayPattern

Invariant culture.

NativeCalendarName

Invariant culture.

NumberFormatInfo

Member

Default

NaNSymbol

Invariant culture.

NegativeInfinitySymbol

Invariant culture.

PercentDecimalDigits

Invariant culture.

PercentDecimalSeparator

Invariant culture.

PercentGroupSeparator

Invariant culture.

PercentGroupSizes

Invariant culture.

PercentNegativePattern

Invariant culture.

PercentPositivePattern

Invariant culture.

PercentSymbol

Invariant culture.

PerMilleSymbol

Invariant culture.

PositiveInfinitySymbol

Invariant culture.

CompareInfo

Member

Default

IndexOf

(none)

IsPrefix

(none)

IsSuffix

(none)

LastIndexOf

(none)

TextInfo

Member

Default

ToTitleCase

The same result as for the en-US culture, unless the Windows locale ANSI code page is Turkish. In this case, the default is the same result as for the tr-TR culture.

Calendar

Member

Default

All

The corresponding member of the calendar returned by InvariantCulture.

Culture Names for Recent ELK Versions

Your application creates a culture by specifying the culture name or culture identifier of the culture in a CultureInfo constructor. Windows cultures shipped in ELK version 1 and 2 are listed below. A complete table of supported cultures with names and identifiers is found on the NLS information page at the Go Global Developer Center (https://msdn.microsoft.com/en-us/goglobal/bb896001.aspx.

  • Bengali (India)

  • Bosnian (Cyrillic, Bosnia and Herzegovina)

  • Bosnian (Latin, Bosnia and Herzegovina)

  • Croatian (Bosnia and Herzegovina)

  • Dari (Afghanistan)

  • Filipino (Phillipines)

  • Inuktitut (Latin, Canada)

  • Irish (Ireland)

  • isiXhosa (South Africa)

  • isiZulu (South Africa)

  • Luxembourgish (Luxembourg)

  • Malayalam (India)

  • Maltese (Malta)

  • Maori (New Zealand)

  • Mapudungun (Chile)

  • Mohawk (Canada)

  • Nepali (Nepal)

  • Pashto (Afghanistan)

  • Quechua (Bolivia)

  • Quechua (Ecuador)

  • Quechua (Peru)

  • Romansh (Switzerland)

  • Sami, Inari (Finland)

  • Sami, Lule (Norway)

  • Sami, Lule (Sweden)

  • Sami, Northern (Finland)

  • Sami, Northern (Norway)

  • Sami, Northern (Sweden)

  • Sami, Skolt (Finland)

  • Sami, Southern (Norway)

  • Sami, Southern (Sweden)

  • Serbian (Cyrillic, Bosnia and Herzegovina)

  • Serbian (Latin, Bosnia and Herzegovina)

  • Sesotho sa Leboa (South Africa)

  • Setswana (South Africa)

  • Upper Sorbian (Germany)

  • Welsh (United Kingdom)

See Also

Tasks

How to: Create Custom Cultures

Reference

CultureInfo

CultureAndRegionInfoBuilder