CultureInfo.GetCultures Method (System.Globalization)

MSDN Library
.NET Development
.NET Framework 3.5
.NET Framework Class Library
System.Globalization Namespace
CultureInfo Class
CultureInfo Methods

ClearCachedData Method
Clone Method
CreateSpecificCulture Method
Equals Method
GetConsoleFallbackUICulture Method
GetCultureInfo Method
GetCultureInfoByIetfLanguageTag Method

GetCultures Method

GetFormat Method
GetHashCode Method
ReadOnly Method
ToString Method

CultureInfo..::.GetCultures Method
This page is specific to:.NET Framework Version:1.1 2.0 3.03.54.0

.NET Framework Class Library

CultureInfo..::.GetCultures Method

Gets the list of supported cultures filtered by the specified CultureTypes parameter.

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

Syntax

C++

JScript

Copy to Clipboard Print

'Usage

Dim types As CultureTypes
Dim returnValue As CultureInfo()

returnValue = CultureInfo.GetCultures(types)

'Declaration

Public Shared Function GetCultures ( _
    types As CultureTypes _
) As CultureInfo()

Parameters

types: Type: System.Globalization..::.CultureTypes
A bitwise combination of CultureTypes values that filter the cultures to retrieve.

Return Value

Type: array<System.Globalization..::.CultureInfo>[]()[]
An array of type CultureInfo that contains the cultures specified by the types parameter. The array of cultures is unsorted.

Exceptions

Exception	Condition
ArgumentOutOfRangeException	types specifies an invalid combination of CultureTypes values.

Remarks

Setting the types parameter to the SpecificCultures value returns all specific cultures. Setting types to the NeutralCultures value returns all neutral cultures and the invariant culture. Setting types to the AllCultures value returns all neutral and specific cultures, cultures installed in the Windows system, and custom cultures created by the user.

Examples

The following code example displays several properties of the neutral cultures.

Note:
The example displays the zh-CHS and zh-CHT cultures with the 0x0004 and 0x7C04 culture identifiers, respectively. However, your Windows Vista applications should use the zh-Hans name instead of "zh-CHS" and the zh-Hant name instead of "zh-CHT". The zh-Hans and zh-Hant names represent the current standard, and should be used unless you have a reason for using the older names.

C++

JScript

Copy to Clipboard Print

Imports System
Imports System.Globalization

Public Class SamplesCultureInfo

   Public Shared 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 

End Class 'SamplesCultureInfo


'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-CHS  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

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

Reference

CultureInfo Class

CultureInfo Members

System.Globalization Namespace

CultureTypes