RegionInfo (Clase) (System.Globalization)

Biblioteca de clases de .NET Framework

RegionInfo (Clase)

Actualización: noviembre 2007

Contiene información sobre el país o la región.

Espacio de nombres: System.Globalization
Ensamblado: mscorlib (en mscorlib.dll)

Sintaxis

Visual Basic (Declaración)

<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public Class RegionInfo

Visual Basic (Uso)

Dim instance As RegionInfo

[SerializableAttribute]
[ComVisibleAttribute(true)]
public class RegionInfo

Visual C++

[SerializableAttribute]
[ComVisibleAttribute(true)]
public ref class RegionInfo

/** @attribute SerializableAttribute */ 
/** @attribute ComVisibleAttribute(true) */
public class RegionInfo

JScript

public class RegionInfo

Comentarios

A diferencia de CultureInfo, RegionInfo no representa las preferencias del usuario y no depende del idioma ni de la referencia cultural del usuario.

El nombre de RegionInfo es uno de los códigos de dos letras definidos en ISO 3166 para el país o la región. La distinción entre mayúsculas y minúsculas no es relevante. Las propiedades Name, TwoLetterISORegionName y ThreeLetterISORegionName recuperan los códigos adecuados en mayúsculas.

A continuación, se incluye una lista con los nombres de RegionInfo predefinidos permitidos y utilizados por ésta y otras clases en el espacio de nombres System.Globalization.

Código de letras de ISO 3166 2	Código de letras de ISO 3166 3	País o región
AE	ARE	Emiratos Árabes Unidos
AL	ALB	Albania
AM	ARM	Armenia
AR	ARG	Argentina
AT	AUT	Austria
AU	AUS	Australia
AZ	AZE	Azerbaiyán
BE	BEL	Bélgica
BG	BGR	Bulgaria
BH	BHR	Bahréin
BN	BRN	Brunéi Darussalam
BO	BOL	Bolivia
BR	BRA	Brasil
BY	BLR	Bielorrusia
BZ	BLZ	Belice
CA	CAN	Canadá
CB	CAR	Caribe
CH	CHE	Suiza
CL	CHL	Chile
CN	CHN	China
CO	COL	Colombia
CR	CRI	Costa Rica
CZ	CZE	República Checa
DE	DEU	Alemania
DK	DNK	Dinamarca
DO	DOM	República Dominicana
DZ	DZA	Argelia
EC	ECU	Ecuador
EE	EST	Estonia
EG	EGY	Egipto
ES	ESP	España
FI	FIN	Finlandia
FO	FRO	Islas Feroe
FR	FRA	Francia
GB	GBR	Reino Unido
GE	GEO	Georgia
GR	GRC	Grecia
GT	GTM	Guatemala
HK	HKG	Zona administrativa especial de Hong Kong
HN	HND	Honduras
HR	HRV	Croacia
HU	HUN	Hungría
ID	IDN	Indonesia
IE	IRL	Irlanda
IL	ISR	Israel
IN	IND	India
IQ	IRQ	Iraq
IR	IRN	Irán
IS	ISL	Islandia
IT	ITA	Italia
JM	JAM	Jamaica
JO	JOR	Jordania
JP	JPN	Japón
KE	KEN	Kenia
KG	KGZ	Kirguizistán
KR	KOR	Corea
KW	KWT	Kuwait
KZ	KAZ	Kazajistán
LB	LBN	Líbano
LI	LIE	Liechtenstein
LT	LTU	Lituania
LU	LUX	Luxemburgo
LV	LVA	Letonia
LY	LBY	Libia
MA	MAR	Marruecos
MC	MCO	Mónaco
MK	MKD	FYROM
MN	MNG	Mongolia
MO	MAC	Macao SAR
MV	MDV	Maldivas
MX	MEX	México
MY	MYS	Malasia
NI	NIC	Nicaragua
NL	NLD	Países Bajos
NO	NOR	Noruega
NZ	NZL	Nueva Zelanda
OM	OMN	Omán
PA	PAN	Panamá
PE	PER	Perú
PH	PHL	Filipinas
PK	PAK	Pakistán
PL	POL	Polonia
PR	PRI	Puerto Rico
PT	PRT	Portugal
PY	PRY	Paraguay
QA	QAT	Qatar
RO	ROM	Rumanía
RU	RUS	Rusia
SA	SAU	Arabia Saudí
SE	SWE	Suecia
SG	SGP	Singapur
SI	SVN	Eslovenia
SK	SVK	Eslovaquia
SP	SPB	Serbia
SV	SLV	El Salvador
SY	SYR	Siria
TH	THA	Tailandia
TN	TUN	Túnez
TR	TUR	Turquía
TT	TTO	Trinidad y Tobago
TW	TWN	Taiwán
UA	UKR	Ucrania
US	USA	Estados Unidos
UY	URY	Uruguay
UZ	UZB	Uzbekistán
VE	VEN	Venezuela
VN	VNM	Vietnam
YE	YEM	Yemen
ZA	ZAF	Sudáfrica
ZW	ZWE	Zimbabue

A continuación, se incluye una lista de los símbolos de moneda ISO 4217 devueltos por la propiedad ISOCurrencySymbol.

País/región	Nombre de moneda	Símbolo de moneda ISO 4217
Emiratos Árabes Unidos	Dirham de Emiratos Árabes Unidos	AED
Albania	Lek	ALL
Armenia	Dram armenio	AMD
Argentina	Peso argentino	ARS
Austria	Euro	EUR
Australia	Dólar australiano	AUD
Azerbaiyán	Manat azerí	AZM
Bélgica	Euro	EUR
Bulgaria	Lev	BGL
Bahréin	Dinar bahriní	BHD
Brunéi Darussalam	Dólar de Brunéi	BND
Bolivia	Boliviano	BOB
Brasil	Real	BRL
Bielorrusia	Rublo bielorruso	BYB
Belice	Dólar de Belice	BZD
Canadá	Dólar canadiense	CAD
Caribe	Dólar de EE.UU.	USD
Suiza	Franco suizo	CHF
Chile	Peso chileno	CLP
China	Yuan renminbi	CNY
Colombia	Peso colombiano	COP
Costa Rica	Colón costarricense	CRC
República Checa	Corona checa	CZK
Alemania	Euro	EUR
Dinamarca	Corona danesa	DKK
República Dominicana	Peso dominicano	DOP
Argelia	Dinar argelino	DZD
Ecuador	Dólar de EE.UU.	USD
Estonia	Corona estonia	EEK
Egipto	Libra egipcia	EGP
España	Euro	EUR
Finlandia	Euro	EUR
Islas Feroe	Corona danesa	DKK
Francia	Euro	EUR
Reino Unido	Libra esterlina	GBP
Georgia	Lari	GEL
Grecia	Euro	EUR
Guatemala	Quetzal	GTQ
Zona administrativa especial de Hong Kong	Dólar de Hong Kong	HKD
Honduras	Lempira	HNL
Croacia	Kuna	HRK
FYROM	Denar	MKD
Hungría	Forint	HUF
Indonesia	Rupia indonesia	IDR
Irlanda	Euro	EUR
Israel	Nuevo sheqel	ILS
India	Rupia india	INR
Iraq	Dinar iraquí	IQD
Irán	Rial iraní	IRR
Islandia	Corona islandesa	ISK
Italia	Euro	EUR
Jamaica	Dólar de Jamaica	JMD
Jordania	Dinar jordano	JOD
Japón	Yen	JPY
Kenia	Chelín keniano	KES
Kirguizistán	Som	KGS
Corea	Won	KRW
Kuwait	Dinar kuwaití	KWD
Kazajistán	Tenge	KZT
Líbano	Libra libanesa	LBP
Liechtenstein	Franco suizo	CHF
Lituania	Litas	LTL
Luxemburgo	Euro	EUR
Letonia	Lats	LVL
Libia	Dinar libio	LYD
Marruecos	Dirham marroquí	MAD
Mónaco	Euro	EUR
Mongolia	Tugrik	MNT
Macao SAR	Pataca	MOP
Maldivas	Rufiyaa	MVR
México	Peso mexicano	MXN
Malasia	Ringgit	MYR
Nicaragua	Córdoba	NIO
Países Bajos	Euro	EUR
Noruega	Corona noruega	NOK
Nueva Zelanda	Dólar neozelandés	NZD
Omán	Rial omaní	OMR
Panamá	Balboa	PAB
Perú	Nuevo Sol	PEN
Filipinas	Peso filipino	PHP
Pakistán	Rupia paquistaní	PKR
Polonia	Zloty	PLN
Puerto Rico	Dólar de EE.UU.	USD
Portugal	Euro	EUR
Paraguay	Guaraní	PYG
Qatar	Riyal de Qatar	QAR
Rumanía	Leu rumano	ROL
Rusia	Rublo ruso	RUR
Arabia Saudí	Riyal saudí	SAR
Suecia	Corona sueca	SEK
Singapur	Dólar singapurense	SGD
Eslovenia	Tolar	SIT
Eslovaquia	Corona eslovaca	SKK
Serbia	Dinar serbio	YUN
El Salvador	Dólar de EE.UU.	USD
Siria	Libra siria	SYP
Tailandia	Baht	THB
Túnez	Dinar tunecino	TND
Turquía	Nueva lira turca	YTL
Trinidad y Tobago	Dólar de Trinidad y Tobago	TTD
Taiwán	Nuevo dólar de Taiwán	TWD
Ucrania	Jrivnia	UAH
Estados Unidos	Dólar de EE.UU.	USD
Uruguay	Peso uruguayo	UYU
Uzbekistán	Sum	UZS
Venezuela	Bolívar	VEB
Vietnam	Dong	VND
Yemen	Rial yemení	YER
Sudáfrica	Rand	ZAR
Zimbabue	Dólar de Zimbabue	ZWD

Cuando sea posible, es mejor que las aplicaciones usen los nombres de la referencia cultural, por ejemplo, "en-US", con un objeto RegionInfo. Se puede usar un nombre de país o región, como "US", en el constructor de clase. Sin embargo, esta técnica no siempre produce los resultados adecuados. Las propiedades RegionInfo, por ejemplo, DisplayName, dependen de los nombres tanto del idioma como del país o región. A continuación, se muestran algunos escenarios en los que la aplicación debe preferir los nombres completos de la referencia cultural a los nombres del país o región solos:

El nombre del idioma es básico. Por ejemplo, para la referencia cultural "es-US" de Windows Vista, es probable que una aplicación requiera el nombre para mostrar de "Estados Unidos" en vez de "United States". Por tanto, necesita trabajar con el nombre completo de la referencia cultural en lugar del nombre del país o región solo, que usaría "United States" independientemente del idioma.
Se deben tener en cuenta las diferencias de script. Por ejemplo, el país o región "AZ" está relacionado con las referencias culturales que tienen las variaciones "az-Latn-AZ" y "az-Cyrl-AZ", y los scripts latino y cirílico pueden ser muy distintos para este país o región.
Es importante mantener los detalles. Para una referencia cultural concreta como "en-US", la aplicación puede perder información importante si intenta crear un nuevo objeto RegionInfo o el objeto CultureInfo a partir de "en" o del nombre "US".

Ejemplos

En el ejemplo de código siguiente se muestran varios miembros de la clase RegionInfo.

Visual Basic

Imports System
Imports System.Globalization


Public Class SamplesRegionInfo   

   Public Shared Sub Main()

      ' Displays the property values of the RegionInfo for "US".
      Dim myRI1 As New 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.
      Dim myRI2 As New RegionInfo(New CultureInfo("en-US", False).LCID)
      If myRI1.Equals(myRI2) Then
         Console.WriteLine("The two RegionInfo instances are equal.")
      Else
         Console.WriteLine("The two RegionInfo instances are NOT equal.")
      End If 

   End Sub 'Main

End Class 'SamplesRegionInfo 


'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.

using System;
using System.Globalization;

public class SamplesRegionInfo  {

   public static void Main()  {

      // Displays the property values of the RegionInfo for "US".
      RegionInfo myRI1 = new 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 = new RegionInfo( new 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.

*/

Visual C++

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.

*/

import System.*;
import System.Globalization.*;

public class SamplesRegionInfo
{   
    public static void main(String[] args)
    {
        // Displays the property values of the RegionInfo for "US".
        RegionInfo myRI1 =  new RegionInfo("US");
        Console.WriteLine("   Name:                         {0}",
            myRI1.get_Name());
        Console.WriteLine("   DisplayName:                  {0}",
            myRI1.get_DisplayName());
        Console.WriteLine("   EnglishName:                  {0}", 
            myRI1.get_EnglishName());
        Console.WriteLine("   IsMetric:                     {0}",
            System.Convert.ToString( myRI1.get_IsMetric()));
        Console.WriteLine("   ThreeLetterISORegionName:     {0}", 
            myRI1.get_ThreeLetterISORegionName());
        Console.WriteLine("   ThreeLetterWindowsRegionName: {0}",
            myRI1.get_ThreeLetterWindowsRegionName());
        Console.WriteLine("   TwoLetterISORegionName:       {0}",
            myRI1.get_TwoLetterISORegionName());
        Console.WriteLine("   CurrencySymbol:               {0}",
            myRI1.get_CurrencySymbol());
        Console.WriteLine("   ISOCurrencySymbol:            {0}", 
            myRI1.get_ISOCurrencySymbol());
        Console.WriteLine();

        // Compares the RegionInfo above with another RegionInfo 
        // created using CultureInfo.
        RegionInfo myRI2 =  
            new RegionInfo((new CultureInfo("en-US", false)).get_LCID());
        if ( myRI1.Equals(myRI2)) {
            Console.WriteLine("The two RegionInfo instances are equal.");
        }
        else {
            Console.WriteLine("The two RegionInfo instances are NOT equal.");
        } 
    } //main
} //SamplesRegionInfo

/*
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.

*/

Jerarquía de herencia

System..::.Object
System.Globalization..::.RegionInfo

Seguridad para subprocesos

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Plataformas

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile para Smartphone, Windows Mobile para Pocket PC, Xbox 360

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Información de versión

.NET Framework

Compatible con: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Compatible con: 3.5, 2.0, 1.0

XNA Framework

Compatible con: 2.0, 1.0

Vea también

Referencia

RegionInfo (Miembros)

System.Globalization (Espacio de nombres)

CultureInfo