CultureInfo::GetCultures Method
Gets the list of supported cultures filtered by the specified CultureTypes parameter.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- types
- Type: System.Globalization::CultureTypes
A bitwise combination of the enumeration values that filter the cultures to retrieve.
Return Value
Type: array<System.Globalization::CultureInfo>An array that contains the cultures specified by the types parameter. The array of cultures is unsorted.
| Exception | Condition |
|---|---|
| ArgumentOutOfRangeException | types specifies an invalid combination of CultureTypes values. |
The GetCultures method is most commonly called with the types parameter set to the following values:
CultureTypes::SpecificCultures, which returns all specific cultures.
CultureTypes::NeutralCultures, which returns all neutral cultures and the invariant culture.
CultureTypes::AllCultures, which returns all neutral and specific cultures, cultures installed in the Windows operating system, and custom cultures created by the user.
CultureTypes::UserCustomCulture, which returns all custom cultures, such as those registered by the CultureAndRegionInfoBuilder class.
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. |
using namespace System; using namespace System::Globalization; int main() { // Displays several properties of the neutral cultures. Console::WriteLine( "CULTURE ISO ISO WIN DISPLAYNAME ENGLISHNAME" ); System::Collections::IEnumerator^ enum0 = CultureInfo::GetCultures( CultureTypes::NeutralCultures )->GetEnumerator(); while ( enum0->MoveNext() ) { CultureInfo^ ci = safe_cast<CultureInfo^>(enum0->Current); 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 ); } } /* 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 */
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Note