mscorlib [00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00] 1.0.5000.0 2.0.0.0 4.0.0.0 Gtk# is thread aware, but not thread safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details. System.Object System.Runtime.InteropServices.ComVisible(true)

Unlike the class, the class does not represent user preferences and does not depend on the user's language or culture.

## Names Associated with a RegionInfo Object

The name of a object is one of the two-letter codes defined in ISO 3166 for country/region. Case is not significant. The , , and properties return the appropriate codes in uppercase. For the current list of names, see English country names and code elements on the ISO website.

## Instantiating a RegionInfo Object

To instantiate a object, you pass the constructor either a two-letter region name, such as "US" for the United States, or the name of a specific culture, such as "en-US" for English (United States). However, we recommend that you use a specific culture name instead of a two-letter region name, because a object is not completely language-independent. Several properties, including , , and , depend on culture names.

The following example illustrates the difference in property values for three objects that represent Belgium. The first is instantiated from a region name (BE) only, while the second and third are instantiated from culture names (fr-BE for French (Belgium) and and nl-BE for Dutch (Belgium), respectively). The example uses reflection to retrieve the property values of each object.

code reference: System.Globalization.RegionInfo#2

In scenarios such as the following, use culture names instead of country/region names when you instantiate a object:

When the language name is of primary importance. For example, for the es-US culture name, you'll probably want your application to display "Estados Unidos" instead of "United States". Using the country/region name (US) alone yields "United States" regardless of the language, so you should work with the culture name instead.

When script differences must be considered. For example, the country/region AZ deals with Azerbaijani cultures that have the names az-Latn-AZ and az-Cyrl-AZ, and the Latin and Cyrillic scripts can be very different for this country/region.

When maintenance of detail is important. The values returned by members can differ depending on whether the object was instantiated by using a culture name or a region name. For example, the following table lists the differences in return values when a object is instantiated by using the "US" region, the "en-US" culture, and the "es-US" culture.

Member

"US"

"en-US"

"es-US"

US Dollar

US Dollar

Dólar de EE.UU.

US

en-US

es-US

United States

United States

Estados Unidos

US

en-US

es-US

Contains information about the country/region.

- Constructor
  1.0.5000.0
  2.0.0.0
  4.0.0.0

  is the recommended constructor for instantiating a object. Unlike the constructor that requires a numeric culture identifier as a parameter, its parameter is a more readable culture name or country code.

  The culture identifier is mapped to the corresponding National Language Support (NLS) locale identifier. Detailed culture information appears in the National Language Support (NLS) API Reference at the Go Global Developer Center.

  The value of the property of the new object instantiated by calling this constructor is the ISO 3166 2-letter code for the country/region, not the combined language and country/region code. For example, if a object is instantiated with the culture identifier 0x0409 for the English (United States) culture, the value of the property is "US". In contrast, if a object is instantiated with the combined language and country/region code en-US for the English (United States) culture, the value of the property is "en-US".

  Initializes a new instance of the class based on the country/region associated with the specified culture identifier.

  A culture identifier.
- Constructor
  1.0.5000.0
  2.0.0.0
  4.0.0.0

  The parameter is either one of the codes defined for country/region, or a specific, custom, or Windows-only culture name. Case is not significant. However, the , the , and the properties return the specified code or culture name in uppercase. See further discussion in Names Associated with a RegionInfo Object.

  The predefined names are listed in Country names and code elements on the ISO website.

  You should provide the name of a specific culture rather than just a country/region name in the parameter. For example, en-US for English (United States) or es-US for Spanish (United States) is preferable to US because properties such as and reflect a specific language. az-Latn-AZ or az-Cyrl-AZ is preferable to AZ because properties such as , , and reflect a specific script. The predefined culture names are listed in the National Language Support (NLS) API Reference at the Go Global Developer Center. Note that a call to this constructor throws an if is a neutral culture (such as en for English).

  Initializes a new instance of the class based on the country/region or specific culture, specified by name.

  A string that contains a two-letter code defined in ISO 3166 for country/region.
- Property
  2.0.0.0
  4.0.0.0
  System.Runtime.InteropServices.ComVisible(false)
  System.String To be added. To be added.

  Gets the name, in English, of the currency used in the country/region.

- Property
  2.0.0.0
  4.0.0.0
  System.Runtime.InteropServices.ComVisible(false)
  System.String To be added.

  If the current object is created with a specific culture and more than one language is used in the corresponding country/region, the property retrieves the currency name associated with the specific culture.

  The value of this property depends on the language that is associated with a particular country/region. Therefore, if you intend to use the property, you should instantiate the object by passing the constructor a combined language and country/region code. For example, if a object is instantiated with a combined language and country/region code of "en-CA" for English (Canada), the value of its property is "Canadian Dollar". If it is instantiated with a combined language and country/region code of "fr-CA" for French (Canada), the value of its property is "Dollar canadien". Therefore, creating the RegionInfo object with only a country/region name ("CA" in this case) is not specific enough to distinguish the appropriate native currency name.

  Gets the name of the currency used in the country/region, formatted in the native language of the country/region.

- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.String To be added: an object of type 'string'

  For example, the currency symbol for the United States is "$".

  If the current object is created with a specific culture and more than one language is used in the corresponding country/region, the property returns the currency symbol associated with the specific culture.

  Gets the currency symbol associated with the country/region.

- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Globalization.RegionInfo To be added: an object of type 'RegionInfo'

  The value of this property is based on the culture selected through the regional and language options portion of Control Panel. However, that information can change during the life of the . The class does not automatically detect changes in the system settings, but the property is updated when you call the method.

  Gets the that represents the country/region used by the current thread.

- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.String To be added: an object of type 'string'

  The property displays the country/region name in the language of the localized version of .NET Framework. For example, the property displays the country/region in English on the English version of the .NET Framework, and in Spanish on the Spanish version of the .NET Framework.

  The value of the property is taken from the resource files in the language of the current user interface culture, represented by . Custom regions or those synthesized from the operating system might not have resource information, in which case the value for is the same as the value of the property.

  Gets the full name of the country/region in the language of the localized version of .NET Framework.

- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.String To be added: an object of type 'string'

  For example, a object created for the English (United States) culture displays "United States".

  Gets the full name of the country/region in English.

- Method
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Boolean ``

  This method overrides .

  Determines whether the specified object is the same instance as the current .

  true if the parameter is a object and its property is the same as the property of the current object; otherwise, false.

  The object to compare with the current .
- Property
  2.0.0.0
  4.0.0.0
  System.Runtime.InteropServices.ComVisible(false)
  System.Int32 To be added.

  The application should use the property to provide culture-specific services to customers. For example, the property can be used as a key to access a database record that contains specific information about a country/region.

  This property value corresponds to the Windows GetUserGeoID function. For a list of geographical identifiers, see Table of Geographical Locations in the MSDN Library.

  Gets a unique identification number for a geographical region, country, city, or location.

- Method
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Int32

  This method overrides .

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

  Serves as a hash function for the current , suitable for hashing algorithms and data structures, such as a hash table.

  A hash code for the current .

- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Boolean To be added: an object of type 'bool' To be added

  Gets a value indicating whether the country/region uses the metric system for measurements.

- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.String To be added: an object of type 'string'

  The following example lists some of the ISO 4217 currency symbols returned by the property.

  Country/region

  Currency name

  ISO 4217 currency symbol

  Albania

  Albanian Lek

  ALL

  Algeria

  Algerian Dinar

  DZD

  Argentina

  Argentine Peso

  ARS

  Armenia

  Armenian Dram

  AMD

  Australia

  Australian Dollar

  AUD

  Austria

  Euro

  EUR

  Azerbaijan

  Azerbaijanian Manat

  AZN

  Bahrain

  Bahraini Dinar

  BHD

  Belarus

  Belarussian Ruble

  BYR

  Belgium

  Euro

  EUR

  Belize

  Belize Dollar

  BZD

  Bolivarian Republic of Venezuela

  Venezuelan Bolivar

  VEF

  Bolivia

  Boliviano

  BOB

  Brazil

  Real

  BRL

  Brunei

  Brunei Dollar

  BND

  Bulgaria

  Bulgarian Lev

  BGN

  Canada

  Canadian Dollar

  CAD

  Caribbean

  US Dollar

  USD

  Chile

  Chilean Peso

  CLP

  Colombia

  Colombian Peso

  COP

  Costa Rica

  Costa Rican Colon

  CRC

  Croatia

  Croatian Kuna

  HRK

  Czech Republic

  Czech Koruna

  CZK

  Denmark

  Danish Krone

  DKK

  Dominican Republic

  Dominican Peso

  DOP

  Ecuador

  US Dollar

  USD

  Egypt

  Egyptian Pound

  EGP

  El Salvador

  U.S. Dollar

  USD

  Estonia

  Estonian Kroon

  EEK

  Ethiopia

  Ethiopian Birr

  ETB

  Faroe Islands

  Danish Krone

  DKK

  Finland

  Euro

  EUR

  France

  Euro

  EUR

  Georgia

  Lari

  GEL

  Germany

  Euro

  EUR

  Greece

  Euro

  EUR

  Guatemala

  Guatemalan Quetzal

  GTQ

  Honduras

  Honduran Lempira

  HNL

  Hong Kong SAR

  Hong Kong Dollar

  HKD

  Hungary

  Hungarian Forint

  HUF

  Iceland

  Icelandic Krona

  ISK

  India

  Indian Rupee

  INR

  Indonesia

  Indonesian Rupiah

  IDR

  Iran

  Iranian Rial

  IRR

  Iraq

  Iraqi Dinar

  IQD

  Ireland

  Euro

  EUR

  Islamic Republic of Pakistan

  Pakistan Rupee

  PKR

  Israel

  Israeli New Shekel

  ILS

  Italy

  Euro

  EUR

  Jamaica

  Jamaican Dollar

  JMD

  Japan

  Japanese Yen

  JPY

  Jordan

  Jordanian Dinar

  JOD

  Kazakhstan

  Tenge

  KZT

  Kenya

  Kenyan Shilling

  KES

  Korea

  Korean Won

  KRW

  Kuwait

  Kuwaiti Dinar

  KWD

  Kyrgyzstan

  som

  KGS

  Latvia

  Latvian Lats

  LVL

  Lebanon

  Lebanese Pound

  LBP

  Libya

  Libyan Dinar

  LYD

  Liechtenstein

  Swiss Franc

  CHF

  Lithuania

  Lithuanian Litas

  LTL

  Luxembourg

  Euro

  EUR

  Macao SAR

  Macao Pataca

  MOP

  Macedonia (FYROM)

  Macedonian Denar

  MKD

  Malaysia

  Malaysian Ringgit

  MYR

  Maldives

  Rufiyaa

  MVR

  Mexico

  Mexican Peso

  MXN

  Mongolia

  Tugrik

  MNT

  Morocco

  Moroccan Dirham

  MAD

  Netherlands

  Euro

  EUR

  New Zealand

  New Zealand Dollar

  NZD

  Nicaragua

  Nicaraguan Cordoba Oro

  NIO

  Norway

  Norwegian Krone

  NOK

  Oman

  Omani Rial

  OMR

  Panama

  Panamanian Balboa

  PAB

  Paraguay

  Paraguay Guarani

  PYG

  People's Republic of China

  PRC Renminbi

  CNY

  Peru

  Peruvian Nuevo Sol

  PEN

  Philippines

  Philippine Peso

  PHP

  Poland

  Polish Zloty

  PLN

  Portugal

  Euro

  EUR

  Principality of Monaco

  Euro

  EUR

  Puerto Rico

  US Dollar

  USD

  Qatar

  Qatari Rial

  QAR

  Romania

  Romanian Leu

  RON

  Russia

  Russian Ruble

  RUB

  Saudi Arabia

  Saudi Riyal

  SAR

  Serbia

  Serbian Dinar

  RSD

  Singapore

  Singapore Dollar

  SGD

  Slovakia

  Euro

  EUR

  Slovenia

  Euro

  EUR

  South Africa

  South African Rand

  ZAR

  Spain

  Euro

  EUR

  Sweden

  Swedish Krona

  SEK

  Switzerland

  Swiss Franc

  CHF

  Syria

  Syrian Pound

  SYP

  Taiwan

  New Taiwan Dollar

  TWD

  Thailand

  Thai Baht

  THB

  Trinidad and Tobago

  Trinidad Dollar

  TTD

  Tunisia

  Tunisian Dinar

  TND

  Turkey

  Turkish Lira

  TRY

  Ukraine

  Ukrainian Hryvnia

  UAH

  United Arab Emirates

  UAE Dirham

  AED

  United Kingdom

  UK Pound Sterling

  GBP

  United States

  US Dollar

  USD

  Uruguay

  Peso Uruguayo

  UYU

  Uzbekistan

  Uzbekistan Som

  UZS

  Vietnam

  Vietnamese Dong

  VND

  Yemen

  Yemeni Rial

  YER

  Zimbabwe

  Zimbabwe Dollar

  ZWL

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

- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.String To be added: an object of type 'string'

  If the current object is created with the constructor that takes a culture identifier parameter, the property value is one of the two-letter codes defined in ISO 3166 for the country/region and is formatted in uppercase. For example, the two-letter code for the United States is "US".

  If the current object is created with the constructor and is passed a full culture name such as "en-US", the property value is a full culture name and not just the region name.

  Gets the name or ISO 3166 two-letter country/region code for the current object.

- Property
  2.0.0.0
  4.0.0.0
  System.Runtime.InteropServices.ComVisible(false)
  System.String To be added.

  The property retrieves a full culture name if the RegionInfo object is constructed using a full culture name.

  We recommend that you use the culture name—for example, "en-US" for English (United States)—to access the property. The string used for this property depends on the language associated with the country/region. For example, the culture names en-US for English (United States) and es-US for Spanish (United States) can retrieve different values on Windows Vista. Therefore, creating the RegionInfo object with only a country/region name of US is not specific enough to distinguish the appropriate string.

  Gets the name of a country/region formatted in the native language of the country/region.

- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.String To be added: an object of type 'string'

  The property contains the three-letter code defined in ISO 3166 for this country/region. For example, the three-letter code for United States is "USA".

  Case is not significant. However, the , the , and the properties return the appropriate code in uppercase.

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

- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.String To be added: an object of type 'string'

  For example, the three-letter code for United States is "USA".

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

- Method
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.String

  This method overrides .

  This method returns the value of the property.

  Case is not significant. However, the , the , and the properties return the appropriate code in uppercase.

  The predefined names are listed in the class topic.

  Returns a string containing the culture name or ISO 3166 two-letter country/region codes specified for the current .

  A string containing the culture name or ISO 3166 two-letter country/region codes defined for the current .

- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.String To be added: an object of type 'string'

  The 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".

  In some cases, the property may have more than two characters. For example, the value of the property for the Caribbean region is "029".

  Case is not significant. However, the , the , and the properties return the appropriate code in uppercase.

  If you want to persist a object or communicate it between processes, you should instantiate it by using a full culture name rather than a two-letter ISO region code. Because properties depend on script and language, instantiating a object by using only a region code loses context and data.

  The predefined names are listed in English country names and code elements on the ISO website.

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