RegionInfo Constructor (String)

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

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

new : 
        name:string -> RegionInfo

Parameters

name
Type: System.String

A string that contains a two-letter code defined in ISO 3166 for country/region.

-or-

A string that contains the culture name for a specific culture, custom culture, or Windows-only culture. If the culture name is not in RFC 4646 format, your application should specify the entire culture name instead of just the country/region.

ExceptionCondition
ArgumentNullException

name is a null reference (Nothing in Visual Basic).

ArgumentException

name is not a valid country/region name or specific culture name.

The name 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 Name, the TwoLetterISORegionName, and the ThreeLetterISORegionName properties return the specified code or culture name in uppercase. See further discussion in NIB: Names Associated with a RegionInfo Object.

The predefined RegionInfo 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 name parameter. For example, en-US for English (United States) or es-US for Spanish (United States) is preferable to US because properties such as NativeName and CurrencyNativeName reflect a specific language. az-Latn-AZ or az-Cyrl-AZ is preferable to AZ because properties such as NativeName, CurrencyNativeName, and CurrencySymbol 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 ArgumentException if name is a neutral culture (such as en for English).

Notes to Callers

This constructor accepts only specific cultures or country/region codes. However, some neutral culture names are the same as country/region codes. In this case, name is interpreted as a country/region code rather than a neutral culture name, and this constructor does not throw an ArgumentException.

The following code example compares two instances of RegionInfo that were created differently.

No code example is currently available or this language may not be supported.

The following code example creates instances of RegionInfo using culture names.

No code example is currently available or this language may not be supported.

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

.NET for Windows Store apps

Supported in: Windows 8

.NET for Windows Phone apps

Supported in: Windows Phone 8.1, Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

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

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft