System.Globalization.RegionInfo Class

Assembly: Mscorlib.dll
Namespace: System.Globalization
Summary
Contains information about the country/region.
C# Syntax:
[Serializable]
public class RegionInfo
Thread Safety
This type is safe for multithreaded operations.
Remarks
In contrast to CultureInfo, RegionInfo does not represent preferences of the user and does not depend on the user's language or culture.

The RegionInfo name is one of the two-letter codes defined in ISO 3166 for country/region. Case is not significant; however, the RegionInfo.Name, the RegionInfo.TwoLetterISORegionName, and the RegionInfo.ThreeLetterISORegionName properties return the appropriate code in uppercase.

The following is a list of the predefined RegionInfo names accepted and used by this class and other classes in the System.Globalization namespace.



ISO 3166 2-letter code ISO 3166 3-letter code Country/Region
AE ARE United Arab Emirates
AL ALB Albania
AM ARM Armenia
AR ARG Argentina
AT AUT Austria
AU AUS Australia
AZ AZE Azerbaijan
BE BEL Belgium
BG BGR Bulgaria
BH BHR Bahrain
BN BRN Brunei
BO BOL Bolivia
BR BRA Brazil
BY BLR Belarus
BZ BLZ Belize
CA CAN Canada
CB CAR Caribbean
CH CHE Switzerland
CL CHL Chile
CN CHN China
CO COL Colombia
CR CRI Costa Rica
CZ CZE Czech Republic
DE DEU Germany
DK DNK Denmark
DO DOM Dominican Republic
DZ DZA Algeria
EC ECU Ecuador
EE EST Estonia
EG EGY Egypt
ES ESP Spain
FI FIN Finland
FO FRO Faroe Islands
FR FRA France
GB GBR United Kingdom
GE GEO Georgia
GR GRC Greece
GT GTM Guatemala
HK HKG Hong Kong SAR
HN HND Honduras
HR HRV Croatia
HU HUN Hungary
ID IDN Indonesia
IE IRL Ireland
IL ISR Israel
IN IND India
IQ IRQ Iraq
IR IRN Iran
IS ISL Iceland
IT ITA Italy
JM JAM Jamaica
JO JOR Jordan
JP JPN Japan
KE KEN Kenya
KG KGZ Kyrgyzstan
KR KOR Korea
KW KWT Kuwait
KZ KAZ Kazakhstan
LB LBN Lebanon
LI LIE Liechtenstein
LT LTU Lithuania
LU LUX Luxembourg
LV LVA Latvia
LY LBY Libya
MA MAR Morocco
MC MCO Monaco
MK MKD FYROM
MN MNG Mongolia
MO MAC Macau SAR
MV MDV Maldives
MX MEX Mexico
MY MYS Malaysia
NI NIC Nicaragua
NL NLD The Netherlands
NO NOR Norway
NZ NZL New Zealand
OM OMN Oman
PA PAN Panama
PE PER Peru
PH PHL Philippines
PK PAK Pakistan
PL POL Poland
PR PRI Puerto Rico
PT PRT Portugal
PY PRY Paraguay
QA QAT Qatar
RO ROM Romania
RU RUS Russia
SA SAU Saudi Arabia
SE SWE Sweden
SG SGP Singapore
SI SVN Slovenia
SK SVK Slovakia
SP SPB Serbia
SV SLV El Salvador
SY SYR Syria
TA TAT Russia
TH THA Thailand
TN TUN Tunisia
TR TUR Turkey
TT TTO Trinidad and Tobago
TW TWN Taiwan
UA UKR Ukraine
US USA United States
UY URY Uruguay
UZ UZB Uzbekistan
VE VEN Venezuela
VN VNM Vietnam
YE YEM Yemen
ZA ZAF South Africa
ZW ZWE Zimbabwe

The following is a list of the ISO 4217 currency symbols returned by the RegionInfo.ISOCurrencySymbol property.



Country/Region Currency name ISO 4217 currency symbol
United Arab Emirates UAE Dirham AED
Albania Lek ALL
Armenia Armenian Dram AMD
Argentina Argentine Peso ARS
Austria Euro EUR
Australia Australian Dollar AUD
Azerbaijan Azerbaijanian Manat AZM
Belgium Euro EUR
Bulgaria Lev BGL
Bahrain Bahraini Dinar BHD
Brunei Brunei Dollar BND
Bolivia Boliviano BOB
Brazil Brazilian Real BRL
Belarus Belarussian Ruble BYB
Belize Belize Dollar BZD
Canada Canadian Dollar CAD
Caribbean US Dollar USD
Switzerland Swiss Franc CHF
Chile Chilean Peso CLP
China Yuan Renminbi CNY
Colombia Colombian Peso COP
Costa Rica Costa Rican Colon CRC
Czech Republic Czech Koruna CZK
Germany Euro EUR
Denmark Danish Krone DKK
Dominican Republic Dominican Peso DOP
Algeria Algerian Dinar DZD
Ecuador US Dollar USD
Estonia Kroon EEK
Egypt Egyptian Pound EGP
Spain Euro EUR
Finland Euro EUR
Faroe Islands Danish Krone DKK
France Euro EUR
United Kingdom Pound Sterling GBP
Georgia Lari GEL
Greece Euro EUR
Guatemala Quetzal GTQ
Hong Kong SAR Hong Kong Dollar HKD
Honduras Lempira HNL
Croatia Croatian kuna HRK
FYROM Denar MKD
Hungary Forint HUF
Indonesia Rupiah IDR
Ireland Euro EUR
Israel New Israeli Sheqel ILS
India Indian Rupee INR
Iraq Iraqi Dinar IQD
Iran Iranian Rial IRR
Iceland Iceland Krona ISK
Italy Euro EUR
Jamaica Jamaican Dollar JMD
Jordan Jordanian Dinar JOD
Japan Yen JPY
Kenya Kenyan Shilling KES
Kyrgyzstan Som KGS
Korea Won KRW
Kuwait Kuwaiti Dinar KWD
Kazakhstan Tenge KZT
Lebanon Lebanese Pound LBP
Liechtenstein Swiss Franc CHF
Lithuania Lithuanian Litus LTL
Luxembourg Euro EUR
Latvia Latvian Lats LVL
Libya Libyan Dinar LYD
Morocco Moroccan Dirham MAD
Monaco Euro EUR
Mongolia Tugrik MNT
Macau SAR Pataca MOP
Maldives Rufiyaa MVR
Mexico Mexican Peso MXN
Malaysia Malaysian Ringgit MYR
Nicaragua Cordoba Oro NIO
The Netherlands Euro EUR
Norway Norwegian Krone NOK
New Zealand New Zealand Dollar NZD
Oman Rial Omani OMR
Panama Balboa PAB
Peru Nuevo Sol PEN
Philippines Philippine Peso PHP
Pakistan Pakistan Rupee PKR
Poland Zloty PLN
Puerto Rico US Dollar USD
Portugal Euro EUR
Paraguay Guarani PYG
Qatar Qatari Rial QAR
Romania Leu ROL
Russia Russian Ruble RUR
Saudi Arabia Saudi Riyal SAR
Sweden Swedish Krona SEK
Singapore Singapore Dollar SGD
Slovenia Tolar SIT
Slovakia Slovak Koruna SKK
Serbia Yugoslavian New Dinar YUN
El Salvador US Dollar USD
Syria Syrian Pound SYP
Thailand Baht THB
Tunisia Tunisian Dinar TND
Turkey Turkish Lira TRL
Trinidad and Tobago Trinidad and Tobago Dollar TTD
Taiwan New Taiwan Dollar TWD
Ukraine Hryvnia UAH
United States US Dollar USD
Uruguay Peso Uruguayo UYU
Uzbekistan Uzbekistan Sum UZS
Venezuela Bolivar VEB
Vietnam Dong VND
Yemen Yemeni Rial YER
South Africa Rand ZAR
Zimbabwe Zimbabwe Dollar ZWD
See also:
System.Globalization Namespace | CultureInfo

System.Globalization.RegionInfo Member List:

Public Constructors
ctor #1 Overloaded:
.ctor(int culture)

Initializes a new instance of the RegionInfo class based on the country/region associated with the specified culture identifier.
ctor #2 Overloaded:
.ctor(string name)

Initializes a new instance of the RegionInfo class based on the country/region specified by name.
Public Properties
CurrencySymbol Read-only

Gets the currency symbol associated with the country/region.
CurrentRegion Read-only

Gets the RegionInfo that represents the country/region used by the current thread.
DisplayName Read-only

Gets the full name of the country/region in the language of the localized version of .NET Framework.
EnglishName Read-only

Gets the full name of the country/region in English.
IsMetric Read-only

Gets a value indicating whether the country/region uses the metric system for measurements.
ISOCurrencySymbol Read-only

Gets the three-character ISO 4217 currency symbol associated with the country/region.
Name Read-only

Gets the two-letter code defined in ISO 3166 for the country/region.
ThreeLetterISORegionName Read-only

Gets the three-letter code defined in ISO 3166 for the country/region.
ThreeLetterWindowsRegionName Read-only

Gets the three-letter code assigned by Windows to the country/region represented by this RegionInfo.
TwoLetterISORegionName Read-only

Gets the two-letter code defined in ISO 3166 for the country/region.
Public Methods
Equals Overridden:
Determines whether the specified object is the same instance as the current RegionInfo.
GetHashCode Overridden:
Serves as a hash function for the current RegionInfo, suitable for use in hashing algorithms and data structures, such as a hash table.
GetType
(inherited from System.Object)
See base class member description: System.Object.GetType

Derived from System.Object, the primary base class for all objects.
ToString Overridden:
Returns a string containing the two-letter country/region codes defined in ISO 3166 for the current RegionInfo.
Protected Methods
Finalize
(inherited from System.Object)
See base class member description: System.Object.Finalize

Derived from System.Object, the primary base class for all objects.
MemberwiseClone
(inherited from System.Object)
See base class member description: System.Object.MemberwiseClone

Derived from System.Object, the primary base class for all objects.

Hierarchy:


System.Globalization.RegionInfo Member Details

Overloaded ctor #1
Summary
Initializes a new instance of the RegionInfo class based on the country/region associated with the specified culture identifier.
C# Syntax:
public RegionInfo(
   int culture
);
Parameters:

culture

A culture identifier.

Remarks
The culture identifier is mapped to the corresponding National Language Support (NLS) locale identifier. A list of culture identifiers is provided in the CultureInfo class topic.
See also:
CultureInfo

Return to top


Overloaded ctor #2
Summary
Initializes a new instance of the RegionInfo class based on the country/region specified by name.
C# Syntax:
public RegionInfo(
   string name
);
Parameters:

name

A string containing one of the two-letter codes defined in ISO 3166 for country/region.

Exceptions
Exception Type Condition
ArgumentNullException name is null.
ArgumentException name is not a valid country/region name.
Remarks
The RegionInfo name is one of the two-letter codes defined in ISO 3166 for country/region.

Case is not significant; however, the RegionInfo.Name, the RegionInfo.TwoLetterISORegionName, and the RegionInfo.ThreeLetterISORegionName properties return the appropriate code in uppercase.

The predefined RegionInfo names are listed in the RegionInfo class topic.

Return to top


Property: CurrencySymbol (read-only)
Summary
Gets the currency symbol associated with the country/region.
C# Syntax:
public virtual string CurrencySymbol {get;}
Remarks
For example, the currency symbol for the United States is "$".
See also:
RegionInfo.ISOCurrencySymbol

Return to top


Property: CurrentRegion (read-only)
Summary
Gets the RegionInfo that represents the country/region used by the current thread.
C# Syntax:
public static RegionInfo CurrentRegion {get;}
Remarks
The value of this property is based on the locale selected through Regional and Language Options (or Regional Options or Regional Settings) in Control Panel in Windows. However, that information can change during the life of the AppDomain. The RegionInfo class does not detect changes in the system settings automatically.

Return to top


Property: DisplayName (read-only)
Summary
Gets the full name of the country/region in the language of the localized version of .NET Framework.
C# Syntax:
public virtual string DisplayName {get;}
Remarks
For example, if the .NET Framework English version is installed, the United States is "United States". If the .NET Framework Spanish version is installed, regardless of the language that the system is set to display, the country/region name is displayed in Spanish; therefore, the United States is "Estados Unidos".
See also:
RegionInfo.Name | RegionInfo.EnglishName | RegionInfo.TwoLetterISORegionName | RegionInfo.ThreeLetterISORegionName | RegionInfo.ThreeLetterWindowsRegionName

Return to top


Property: EnglishName (read-only)
Summary
Gets the full name of the country/region in English.
C# Syntax:
public virtual string EnglishName {get;}
Remarks
For example, the United States is "United States".
See also:
RegionInfo.Name | RegionInfo.DisplayName | RegionInfo.TwoLetterISORegionName | RegionInfo.ThreeLetterISORegionName | RegionInfo.ThreeLetterWindowsRegionName

Return to top


Property: IsMetric (read-only)
Summary
Gets a value indicating whether the country/region uses the metric system for measurements.
C# Syntax:
public virtual bool IsMetric {get;}

Return to top


Property: ISOCurrencySymbol (read-only)
Summary
Gets the three-character ISO 4217 currency symbol associated with the country/region.
C# Syntax:
public virtual string ISOCurrencySymbol {get;}
Remarks
A list of the three-character ISO 4217 currency symbols is provided in the RegionInfo class topic. For example, the ISO 4217 currency symbol for the United States dollar is "USD".
See also:
RegionInfo.CurrencySymbol

Return to top


Property: Name (read-only)
Summary
Gets the two-letter code defined in ISO 3166 for the country/region.
C# Syntax:
public virtual string Name {get;}
Remarks
The RegionInfo.Name property is one of the two-letter codes defined in ISO 3166 for country/region. For example, the two-letter code for United States is "US".

This property returns the same value as the RegionInfo.TwoLetterISORegionName property.

Case is not significant; however, the RegionInfo.Name, the RegionInfo.TwoLetterISORegionName, and the RegionInfo.ThreeLetterISORegionName properties return the appropriate code in uppercase.

The predefined RegionInfo names are listed in the RegionInfo class topic.

To get the full name of the country/region, use RegionInfo.DisplayName or RegionInfo.EnglishName.

See also:
RegionInfo.EnglishName | RegionInfo.DisplayName | RegionInfo.TwoLetterISORegionName | RegionInfo.ThreeLetterISORegionName | RegionInfo.ThreeLetterWindowsRegionName

Return to top


Property: ThreeLetterISORegionName (read-only)
Summary
Gets the three-letter code defined in ISO 3166 for the country/region.
C# Syntax:
public virtual string ThreeLetterISORegionName {get;}
Remarks
The RegionInfo.ThreeLetterISORegionName property contains one of the three-letter codes defined in ISO 3166 for country/region. For example, the three-letter code for United States is "USA".

Case is not significant; however, the RegionInfo.Name, the RegionInfo.TwoLetterISORegionName, and the RegionInfo.ThreeLetterISORegionName properties return the appropriate code in uppercase.

The predefined RegionInfo names are listed in the RegionInfo class topic.

See also:
RegionInfo.Name | RegionInfo.EnglishName | RegionInfo.DisplayName | RegionInfo.TwoLetterISORegionName | RegionInfo.ThreeLetterWindowsRegionName

Return to top


Property: ThreeLetterWindowsRegionName (read-only)
Summary
Gets the three-letter code assigned by Windows to the country/region represented by this RegionInfo.
C# Syntax:
public virtual string ThreeLetterWindowsRegionName {get;}
Remarks
For example, the three-letter code for United States is "USA".
See also:
RegionInfo.Name | RegionInfo.EnglishName | RegionInfo.DisplayName | RegionInfo.TwoLetterISORegionName | RegionInfo.ThreeLetterISORegionName

Return to top


Property: TwoLetterISORegionName (read-only)
Summary
Gets the two-letter code defined in ISO 3166 for the country/region.
C# Syntax:
public virtual string TwoLetterISORegionName {get;}
Remarks
The RegionInfo name is one of the two-letter codes defined in ISO 3166 for country/region. For example, the two-letter code for United States is "US".

Case is not significant; however, the RegionInfo.Name, the RegionInfo.TwoLetterISORegionName, and the RegionInfo.ThreeLetterISORegionName properties return the appropriate code in uppercase.

The predefined RegionInfo names are listed in the RegionInfo class topic.

See also:
RegionInfo.Name | RegionInfo.EnglishName | RegionInfo.DisplayName | RegionInfo.ThreeLetterISORegionName | RegionInfo.ThreeLetterWindowsRegionName

Return to top


Overridden Method: Equals(
   object value
)
Summary
Determines whether the specified object is the same instance as the current RegionInfo.
C# Syntax:
public override bool Equals(
   object value
);
Parameters:

value

The object to compare with the current RegionInfo.

Return Value:
true if value is the same instance as the current RegionInfo; otherwise, false.
Remarks
This method overrides Object.Equals.
See also:
Object.Equals

Return to top


Method: Finalize()
Inherited
See base class member description: System.Object.Finalize
C# Syntax:
~RegionInfo();

For more information on members inherited from System.Object click on the link above.

Return to top


Overridden Method: GetHashCode()
Summary
Serves as a hash function for the current RegionInfo, suitable for use in hashing algorithms and data structures, such as a hash table.
C# Syntax:
public override int GetHashCode();
Return Value:
A hash code for the current RegionInfo.
Remarks
This method overrides Object.GetHashCode.

This method generates the same hash code for two objects that are equal according to the RegionInfo.Equals method.

See also:
Object.GetHashCode | Hashtable | RegionInfo.Equals

Return to top


Method: GetType()
Inherited
See base class member description: System.Object.GetType
C# Syntax:
public Type GetType();

For more information on members inherited from System.Object click on the link above.

Return to top


Method: MemberwiseClone()
Inherited
See base class member description: System.Object.MemberwiseClone
C# Syntax:
protected object MemberwiseClone();

For more information on members inherited from System.Object click on the link above.

Return to top


Overridden Method: ToString()
Summary
Returns a string containing the two-letter country/region codes defined in ISO 3166 for the current RegionInfo.
C# Syntax:
public override string ToString();
Return Value:
A string containing the two-letter country/region codes defined in ISO 3166 for the current RegionInfo.
Remarks
This method overrides Object.ToString.

This method returns the value of the RegionInfo.Name property which is one of the two-letter country/region codes defined in ISO 3166.

Case is not significant; however, the RegionInfo.Name, the RegionInfo.TwoLetterISORegionName, and the RegionInfo.ThreeLetterISORegionName properties return the appropriate code in uppercase.

The predefined RegionInfo names are listed in the RegionInfo class topic.

See also:
Object.ToString | RegionInfo.Name

Return to top


Top of page

Copyright (c) 2002 Microsoft Corporation. All rights reserved.