Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase RegionInfo

 

Publicado: octubre de 2016

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

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

System.Object
  System.Globalization.RegionInfo

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

NombreDescripción
System_CAPS_pubmethodRegionInfo(Int32)

Inicializa una nueva instancia de la clase RegionInfo de acuerdo con el país o región asociados a la referencia cultural especificada.

System_CAPS_pubmethodRegionInfo(String)

Inicializa una nueva instancia de la clase RegionInfo de acuerdo con el país o región, o la referencia cultural concreta, especificados por nombre.

NombreDescripción
System_CAPS_pubpropertyCurrencyEnglishName

Obtiene el nombre, en inglés, de la moneda utilizada en el país o región.

System_CAPS_pubpropertyCurrencyNativeName

Obtiene el nombre de la moneda utilizada en el país o región, con el formato del idioma nativo del país o región.

System_CAPS_pubpropertyCurrencySymbol

Obtiene el símbolo de divisa asociado al país o región.

System_CAPS_pubpropertySystem_CAPS_staticCurrentRegion

Obtiene el RegionInfo que representa el país o región utilizado por el subproceso actual.

System_CAPS_pubpropertyDisplayName

Obtiene el nombre completo del país o región en el idioma de la versión localizada de .NET Framework.

System_CAPS_pubpropertyEnglishName

Obtiene el nombre completo del país o región en inglés.

System_CAPS_pubpropertyGeoId

Obtiene un número de identificación único para una región, país, ciudad o ubicación geográfica.

System_CAPS_pubpropertyIsMetric

Obtiene un valor que indica si el país o la región utilizan el sistema métrico para las medidas.

System_CAPS_pubpropertyISOCurrencySymbol

Obtiene el símbolo de divisa ISO 4217 de tres caracteres asociado al país o región.

System_CAPS_pubpropertyName

Obtiene el nombre o el código de país o región de dos letras ISO 3166 para el objeto RegionInfo actual.

System_CAPS_pubpropertyNativeName

Obtiene el nombre de un país o región, con el formato del idioma nativo del país o región.

System_CAPS_pubpropertyThreeLetterISORegionName

Obtiene el código de tres letras definido en ISO 3166 para el país o región.

System_CAPS_pubpropertyThreeLetterWindowsRegionName

Obtiene el código de tres letras asignado por Windows al país o región representado por este RegionInfo.

System_CAPS_pubpropertyTwoLetterISORegionName

Obtiene el código de dos letras definido en ISO 3166 para el país o región.

NombreDescripción
System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es la misma instancia que la RegionInfo actual.(Invalida Object.Equals(Object)).

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Heredado de Object).

System_CAPS_pubmethodGetHashCode()

Sirve como función hash para el objeto RegionInfo actual, que se puede utilizar en algoritmos hash y estructuras de datos, como una tabla hash.(Invalida Object.GetHashCode()).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_pubmethodToString()

Devuelve una cadena que contiene el nombre de la referencia cultural o los códigos de país o región de dos letras ISO 3166 especificados para la RegionInfo actual.(Invalida Object.ToString()).

A diferencia de la CultureInfo (clase), el RegionInfo clase no representa las preferencias del usuario y no depende de lenguaje o la referencia cultural del usuario.

El nombre de un RegionInfo objeto es uno de los códigos de dos letras definidos en ISO 3166 para el país o región. Caso no es significativo. El Name, TwoLetterISORegionName, y ThreeLetterISORegionName propiedades devuelven los códigos adecuados en mayúsculas. La lista actual de RegionInfo nombres, vea English country names and code elements en el sitio Web de la ISO.

Para crear instancias de un RegionInfo de objeto, se pasa el RegionInfo(String) constructor un nombre de región de dos letras, como "US" para Estados Unidos, o el nombre de una referencia cultural específica, como "en-US" para inglés (Estados Unidos). Sin embargo, se recomienda que utilice un nombre de referencia cultural específica en lugar de un nombre de región de dos letras, porque un RegionInfo objeto no es completamente independiente del lenguaje. Varios RegionInfo Propiedades, incluyendo DisplayName, NativeName, y CurrencyNativeName, dependen de los nombres de referencia cultural.

En el ejemplo siguiente se muestra la diferencia en RegionInfo valores de propiedad para tres objetos que representan Bélgica. El primero se crea una instancia de un nombre de región (BE), mientras se crean instancias de los nombres de referencia cultural del segundo y tercer (fr-BE para francés (Bélgica) y y nl-BE para neerlandés (Bélgica), respectivamente). En el ejemplo se utiliza la reflexión para recuperar los valores de propiedad de cada RegionInfo objeto.

using System;
using System.Globalization;
using System.Reflection;

public class Example
{
   public static void Main()
   {
      // Instantiate three Belgian RegionInfo objects.
      RegionInfo BE = new RegionInfo("BE");
      RegionInfo frBE = new RegionInfo("fr-BE");
      RegionInfo nlBE = new RegionInfo("nl-BE");

      RegionInfo[] regions = { BE, frBE, nlBE };
      PropertyInfo[] props = typeof(RegionInfo).GetProperties(BindingFlags.Instance | BindingFlags.Public);

      Console.WriteLine("{0,-30}{1,18}{2,18}{3,18}\n", 
                        "RegionInfo Property", "BE", "fr-BE", "nl-BE");
      foreach (var prop in props) {
         Console.Write("{0,-30}", prop.Name);
         foreach (var region in regions)
            Console.Write("{0,18}", prop.GetValue(region, null));

         Console.WriteLine();
      }
   }
}
// The example displays the following output:
//    RegionInfo Property                           BE             fr-BE             nl-BE
//    
//    Name                                          BE             fr-BE             nl-BE
//    EnglishName                              Belgium           Belgium           Belgium
//    DisplayName                              Belgium           Belgium           Belgium
//    NativeName                                België          Belgique            België
//    TwoLetterISORegionName                        BE                BE                BE
//    ThreeLetterISORegionName                     BEL               BEL               BEL
//    ThreeLetterWindowsRegionName                 BEL               BEL               BEL
//    IsMetric                                    True              True              True
//    GeoId                                         21                21                21
//    CurrencyEnglishName                         Euro              Euro              Euro
//    CurrencyNativeName                          euro              euro              euro
//    CurrencySymbol                                 €                 €                 €
//    ISOCurrencySymbol                            EUR               EUR               EUR

En escenarios como la siguiente, utilice nombres de referencia cultural en lugar de los nombres de país o región al crear instancias de un RegionInfo objeto:

  • Cuando el nombre del idioma es básico. Por ejemplo, el nombre de referencia cultural es-US, probablemente deberá la aplicación para mostrar "Estados Unidos" en lugar de "United States". Con el nombre de país o región (US) solo produce "United States" independientemente del lenguaje, por lo que debe trabajar con el nombre de la referencia cultural en su lugar.

  • Cuando se deben considerar las diferencias de script. Por ejemplo, el país o región AZ trata con referencias culturales Azerbaijani que tienen nombres az-Latn-AZ y az-Cyrl-AZ y el latino y cirílicos scripts pueden ser muy diferentes para este país o región.

  • Cuando el mantenimiento de detalle es importante. Los valores devueltos por RegionInfo miembros pueden diferir dependiendo de si el RegionInfo se crea una instancia de objeto con un nombre de referencia cultural o un nombre de región. Por ejemplo, la siguiente tabla se enumeran las diferencias de vuelta el valor cuando un RegionInfo se crea una instancia de objeto con la región "US", la referencia cultural "en-US" y la referencia cultural "es-US".

    Miembro

    "US"

    "en-US"

    "es-US"

    CurrencyNativeName

    Dólar estadounidense

    Dólar estadounidense

    Dólar de EE. UU.

    Name

    US

    en-US

    es-US

    NativeName

    Estados Unidos

    Estados Unidos

    Estados Unidos

    ToString

    US

    en-US

    es-US

En el ejemplo siguiente se muestra varios miembros de la RegionInfo clase.

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.

*/

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 1.1
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Windows Phone
Disponible desde 8.1

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: