CultureTypes Enumeration

 

Defines the types of culture lists that can be retrieved using the CultureInfo.GetCultures method.

This enumeration has a FlagsAttribute attribute that allows a bitwise combination of its member values.

Namespace:   System.Globalization
Assembly:  mscorlib (in mscorlib.dll)

<SerializableAttribute>
<FlagsAttribute>
<ComVisibleAttribute(True)>
Public Enumeration CultureTypes

Member nameDescription
AllCultures

All cultures that ship with the .NET Framework, including neutral and specific cultures, cultures installed in the Windows operating system, and custom cultures created by the user.

CultureTypes.AllCultures is a composite field that includes the CultureTypes.NeutralCultures, CultureTypes.SpecificCultures, and CultureTypes.InstalledWin32Cultures values.

FrameworkCultures

Obsolete.This member is deprecated; using this value with CultureInfo.GetCultures returns neutral and specific cultures shipped with the .NET Framework 2.0.

InstalledWin32Cultures

All cultures that are installed in the Windows operating system. Note that not all cultures supported by the .NET Framework are installed in the operating system.

NeutralCultures

Cultures that are associated with a language but are not specific to a country/region. The names of .NET Framework cultures consist of the lowercase two-letter code derived from ISO 639-1. For example: "en" (English) is a neutral culture.

ReplacementCultures

Custom cultures created by the user that replace cultures shipped with the .NET Framework.

SpecificCultures

Cultures that are specific to a country/region. The names of these cultures follow RFC 4646 (Windows Vista and later). The format is "<languagecode2>-<country/regioncode2>", where <languagecode2> is a lowercase two-letter code derived from ISO 639-1 and <country/regioncode2> is an uppercase two-letter code derived from ISO 3166. For example, "en-US" for English (United States) is a specific culture.

UserCustomCulture

Custom cultures created by the user.

WindowsOnlyCultures

Obsolete.This member is deprecated. If it is used as an argument to the CultureInfo.GetCultures method, the method returns an empty array.

These culture type values are returned by the CultureInfo.CultureTypes property, and also serve as a filter that limits the cultures returned by the CultureInfo.GetCultures method. For more information on cultures, see CultureInfo.

Generally, your application should enumerate all cultures, using the AllCultures value. This allows enumeration of custom cultures, as well as the other culture types.

Note that the FrameworkCultures and WindowsOnlyCultures members have been deprecated.

The following example demonstrates the CultureTypes enumeration and the CultureTypes property.

' This example demonstrates the CultureTypes enumeration 
' and the CultureInfo.CultureTypes property.

Imports System
Imports System.Globalization

Module Module1
    Public Sub Main()

        ' Create a table of most culture types. 
        Dim mostCultureTypes() As CultureTypes = { _
                CultureTypes.NeutralCultures, _
                CultureTypes.SpecificCultures, _
                CultureTypes.InstalledWin32Cultures, _
                CultureTypes.UserCustomCulture, _
                CultureTypes.ReplacementCultures, _
                CultureTypes.FrameworkCultures, _
                CultureTypes.WindowsOnlyCultures}
        Dim allCultures() As CultureInfo
        Dim combo As CultureTypes

        ' Get and enumerate all cultures.
        allCultures = CultureInfo.GetCultures(CultureTypes.AllCultures)
        Dim ci As CultureInfo
        For Each ci In allCultures
            ' Display the name of each culture.
            Console.WriteLine("Culture: {0}", ci.Name)

            ' Get the culture types of each culture. 
            combo = ci.CultureTypes

            ' Display the name of each culture type flag that is set.
            Console.Write("  ")
            Dim ct As CultureTypes
            For Each ct In mostCultureTypes
                If 0 <> (ct And combo) Then
                    Console.Write("{0} ", ct)
                End If
            Next ct
            Console.WriteLine()
        Next ci

    End Sub 'Main 
End Module

'The following is a portion of the results produced by this code example.
'.
'.
'.
'Culture: tg
'  NeutralCultures InstalledWin32Cultures 
'Culture: ta
'  NeutralCultures InstalledWin32Cultures FrameworkCultures 
'Culture: te
'  NeutralCultures InstalledWin32Cultures FrameworkCultures 
'Culture: syr
'  NeutralCultures InstalledWin32Cultures FrameworkCultures 
'Culture: tg-Cyrl-TJ
'  SpecificCultures InstalledWin32Cultures 
'Culture: ta-IN
'  SpecificCultures InstalledWin32Cultures FrameworkCultures 
'Culture: te-IN
'  SpecificCultures InstalledWin32Cultures FrameworkCultures 
'Culture: syr-SY
'  SpecificCultures InstalledWin32Cultures FrameworkCultures 
'Culture: tg-Cyrl
'  NeutralCultures InstalledWin32Cultures 
'.
'.
'.

The following example displays several properties of the neutral cultures.

Imports System
Imports System.Globalization

Module Module1

   Public Sub Main()

      ' Displays several properties of the neutral cultures.
      Console.WriteLine("CULTURE ISO ISO WIN DISPLAYNAME                              ENGLISHNAME")
      Dim ci As CultureInfo
      For Each ci In CultureInfo.GetCultures(CultureTypes.NeutralCultures)
         Console.Write("{0,-7}", ci.Name)
         Console.Write(" {0,-3}", ci.TwoLetterISOLanguageName)
         Console.Write(" {0,-3}", ci.ThreeLetterISOLanguageName)
         Console.Write(" {0,-3}", ci.ThreeLetterWindowsLanguageName)
         Console.Write(" {0,-40}", ci.DisplayName)
         Console.WriteLine(" {0,-40}", ci.EnglishName)
      Next ci

   End Sub 'Main 



'This code produces the following output.  This output has been cropped for brevity.
'
'CULTURE ISO ISO WIN DISPLAYNAME                              ENGLISHNAME
'ar      ar  ara ARA Arabic                                   Arabic                                  
'bg      bg  bul BGR Bulgarian                                Bulgarian                               
'ca      ca  cat CAT Catalan                                  Catalan                                 
'zh-Hans zh  zho CHS Chinese (Simplified)                     Chinese (Simplified)                    
'cs      cs  ces CSY Czech                                    Czech                                   
'da      da  dan DAN Danish                                   Danish                                  
'de      de  deu DEU German                                   German                                  
'el      el  ell ELL Greek                                    Greek                                   
'en      en  eng ENU English                                  English                                 
'es      es  spa ESP Spanish                                  Spanish                                 
'fi      fi  fin FIN Finnish                                  Finnish                                 
'zh      zh  zho CHS Chinese                                  Chinese                                 
'zh-Hant zh  zho CHT Chinese (Traditional)                    Chinese (Traditional)                   
'zh-CHS  zh  zho CHS Chinese (Simplified) Legacy              Chinese (Simplified) Legacy             
'zh-CHT  zh  zho CHT Chinese (Traditional) Legacy             Chinese (Traditional) Legacy            

End Module

.NET Framework
Available since 1.1
Return to top
Show: