RegionInfo Class
Contains information about the country/region.
Assembly: mscorlib (in mscorlib.dll)
The RegionInfo type exposes the following members.
| Name | Description | |
|---|---|---|
![]() ![]() | RegionInfo(Int32) | Initializes a new instance of the RegionInfo class based on the country/region associated with the specified culture identifier. |
![]() ![]() ![]() | RegionInfo(String) | Initializes a new instance of the RegionInfo class based on the country/region or specific culture, specified by name. |
| Name | Description | |
|---|---|---|
![]() | CurrencyEnglishName | Gets the name, in English, of the currency used in the country/region. |
![]() | CurrencyNativeName | Gets the name of the currency used in the country/region, formatted in the native language of the country/region. |
![]() ![]() ![]() | CurrencySymbol | Gets the currency symbol associated with the country/region. |
![]() ![]() ![]() ![]() | CurrentRegion | Gets the RegionInfo that represents the country/region used by the current thread. |
![]() | DisplayName | Gets the full name of the country/region in the language of the localized version of .NET Framework. |
![]() ![]() ![]() | EnglishName | Gets the full name of the country/region in English. |
![]() | GeoId | Gets a unique identification number for a geographical region, country, city, or location. |
![]() ![]() ![]() | IsMetric | Gets a value indicating whether the country/region uses the metric system for measurements. |
![]() ![]() ![]() | ISOCurrencySymbol | Gets the three-character ISO 4217 currency symbol associated with the country/region. |
![]() ![]() ![]() | Name | Gets the name or ISO 3166 two-letter country/region code for the current RegionInfo object. |
![]() | NativeName | Gets the name of a country/region formatted in the native language of the country/region. |
![]() ![]() | ThreeLetterISORegionName | Gets the three-letter code defined in ISO 3166 for the country/region. |
![]() ![]() | ThreeLetterWindowsRegionName | Gets the three-letter code assigned by Windows to the country/region represented by this RegionInfo. |
![]() ![]() ![]() | TwoLetterISORegionName | Gets the two-letter code defined in ISO 3166 for the country/region. |
| Name | Description | |
|---|---|---|
![]() ![]() ![]() | Equals | Determines whether the specified object is the same instance as the current RegionInfo. (Overrides Object::Equals(Object).) |
![]() ![]() ![]() | Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.) |
![]() ![]() ![]() | GetHashCode | Serves as a hash function for the current RegionInfo, suitable for hashing algorithms and data structures, such as a hash table. (Overrides Object::GetHashCode().) |
![]() ![]() ![]() | GetType | Gets the Type of the current instance. (Inherited from Object.) |
![]() ![]() ![]() | MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
![]() ![]() ![]() | ToString | Returns a string containing the culture name or ISO 3166 two-letter country/region codes specified for the current RegionInfo. (Overrides Object::ToString().) |
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. The Name, TwoLetterISORegionName, and ThreeLetterISORegionName properties return the appropriate codes in uppercase. For the current list of RegionInfo names, see English country names and code elements on the ISO Web site.
When possible, you should use specific culture names -- for example, "en-US" for English (United States) -- when you instantiate a RegionInfo object. You can use just a country/region name, such as "US", in the class constructor. However, this technique does not always yield appropriate results. RegionInfo properties (for example, DisplayName) depend on culture names for both the language and the country/region. Here are some scenarios in which you should use culture names instead of just country/region names:
When the language name is of primary importance. For example, for the "es-US" culture name on Windows Vista, an application probably requires a display name of "Estados Unidos" instead of "United States". Therefore, it needs to work with the culture name instead of the country/region name alone, which yields "United States" regardless of the language.
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. For a specific culture such as English (United States), named "en-US", your application can lose important information if it tries to create a new RegionInfo object from just the country/region name "US".
The following code example demonstrates several members of the RegionInfo class.
using namespace System; using namespace System::Globalization; int main() { // Displays the property values of the RegionInfo for "US". RegionInfo^ myRI1 = gcnew RegionInfo( "US" ); Console::WriteLine( " Name: {0}", myRI1->Name ); Console::WriteLine( " DisplayName: {0}", myRI1->DisplayName ); Console::WriteLine( " EnglishName: {0}", myRI1->EnglishName ); Console::WriteLine( " IsMetric: {0}", myRI1->IsMetric ); Console::WriteLine( " ThreeLetterISORegionName: {0}", myRI1->ThreeLetterISORegionName ); Console::WriteLine( " ThreeLetterWindowsRegionName: {0}", myRI1->ThreeLetterWindowsRegionName ); Console::WriteLine( " TwoLetterISORegionName: {0}", myRI1->TwoLetterISORegionName ); Console::WriteLine( " CurrencySymbol: {0}", myRI1->CurrencySymbol ); Console::WriteLine( " ISOCurrencySymbol: {0}", myRI1->ISOCurrencySymbol ); Console::WriteLine(); // Compares the RegionInfo above with another RegionInfo created using CultureInfo. RegionInfo^ myRI2 = gcnew RegionInfo( (gcnew CultureInfo( "en-US",false ))->LCID ); if ( myRI1->Equals( myRI2 ) ) Console::WriteLine( "The two RegionInfo instances are equal." ); else Console::WriteLine( "The two RegionInfo instances are NOT equal." ); } /* This code produces the following output. Name: US DisplayName: United States EnglishName: United States IsMetric: False ThreeLetterISORegionName: USA ThreeLetterWindowsRegionName: USA TwoLetterISORegionName: US CurrencySymbol: $ ISOCurrencySymbol: USD The two RegionInfo instances are equal. */
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.





