RegionInfo Clase

Definición

Espacio de nombres:

System.Globalization

Ensamblados:

netstandard.dll, System.Runtime.dll

Source:

RegionInfo.cs

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

public ref class RegionInfo

public class RegionInfo

type RegionInfo = class

Public Class RegionInfo

Herencia

Object

RegionInfo

Comentarios

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

Nombres asociados a un objeto RegionInfo

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. El caso no es significativo. Name, TwoLetterISORegionName y ThreeLetterISORegionName devuelven los códigos adecuados en mayúsculas. Para obtener la lista actual de RegionInfo nombres, consulte ISO 3166: Códigos de país.

Creación de instancias de un objeto RegionInfo

Para crear una instancia de un objeto RegionInfo, pasar al constructor RegionInfo(String) un nombre de región de dos letras, como "US" para Estados Unidos, o el nombre de una cultura específica, como "en-US" para inglés (Estados Unidos). Sin embargo, se recomienda usar un nombre de referencia cultural específico en lugar de un nombre de región de dos letras, ya que un RegionInfo objeto no es completamente independiente del lenguaje. Varias RegionInfo propiedades, como DisplayName, NativeNamey CurrencyNativeName, dependen de los nombres de referencia cultural.

En el ejemplo siguiente se muestra la diferencia en los valores de propiedad de RegionInfo tres objetos que representan Bélgica. El primero se instancia a partir de un nombre de región (BE), mientras que el segundo y el tercero se instancian a partir de nombres culturales (fr-BE para francés de Bélgica y nl-BE para neerlandés de Bélgica, respectivamente). En el ejemplo se usa 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 los siguientes, use nombres de referencia cultural en lugar de nombres de país o región al crear una instancia de un RegionInfo objeto:

• Cuando el nombre del idioma es de importancia principal. Por ejemplo, para el nombre de la es-US cultura, probablemente querrá que la aplicación muestre "Estados Unidos" en lugar de "Estados Unidos". El uso del nombre de país o región (US) solo produce "Estados Unidos" independientemente del idioma, de manera que se debe trabajar con el nombre de la cultura en su lugar.

• Cuando se deben tener en cuenta las diferencias de guion. Por ejemplo, el país o región AZ se ocupa de las culturas azerbaiyanas que tienen los nombres az-Latn-AZ y az-Cyrl-AZ, y los scripts latinos y cirílicos pueden ser muy diferentes para este país o región.

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

  Miembro	"US"	"en-US"	"es-US"
  CurrencyNativeName	US Dollar	US Dollar	Dólar de EE.UU.
  Name	US	en-US	es-US
  NativeName	United States	United States	Estados Unidos
  ToString	US	en-US	es-US

Example

  The following example demonstrates several members of the <xref:System.Globalization.RegionInfo> class.

  :::code language="csharp" source="~/snippets/csharp/System.Globalization/RegionInfo/Overview/regioninfo.cs" id="Snippet1":::
  :::code language="vb" source="~/snippets/visualbasic/System.Globalization/RegionInfo/Overview/regioninfo.vb" id="Snippet1":::

Constructores

Nombre	Description
RegionInfo(Int32)	Inicializa una nueva instancia de la RegionInfo clase en función del país o región asociado al identificador de referencia cultural especificado.
RegionInfo(String)	Inicializa una nueva instancia de la RegionInfo clase en función del país o región o referencia cultural específica, especificada por nombre.

Propiedades

Nombre	Description
CurrencyEnglishName	Obtiene el nombre, en inglés, de la moneda usada en el país o región.
CurrencyNativeName	Obtiene el nombre de la moneda usada en el país o región, con formato en el idioma nativo del país o región.
CurrencySymbol	Obtiene el símbolo de moneda asociado al país o región.
CurrentRegion	Obtiene el RegionInfo objeto que representa el país o región utilizado por el subproceso actual.
DisplayName	Obtiene el nombre completo del país o región en el idioma de la versión localizada de .NET.
EnglishName	Obtiene el nombre completo del país o región en inglés.
GeoId	Obtiene un número de identificación único para una región geográfica, un país, una ciudad o una ubicación.
IsMetric	Obtiene un valor que indica si el país o región usa el sistema de métricas para las medidas.
ISOCurrencySymbol	Obtiene el símbolo de moneda ISO 4217 de tres caracteres asociado al país o región.
Name	Obtiene el nombre o el código de país o región ISO 3166 de dos letras para el objeto actual RegionInfo .
NativeName	Obtiene el nombre de un país o región con formato en el idioma nativo del país o región.
ThreeLetterISORegionName	Obtiene el código de tres letras definido en ISO 3166 para el país o región.
ThreeLetterWindowsRegionName	Obtiene el código de tres letras asignado por Windows al país o región representado por este RegionInfo.
TwoLetterISORegionName	Obtiene el código de dos letras definido en ISO 3166 para el país o región.

Métodos

Nombre	Description
Equals(Object)	Determina si el objeto especificado es la misma instancia que la actual RegionInfo.
GetHashCode()	Actúa como una función hash para el objeto actual RegionInfo, adecuado para algoritmos hash y estructuras de datos, como una tabla hash.
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
ToString()	Devuelve una cadena que contiene el nombre de referencia cultural o los códigos de país o región iso 3166 de dos letras especificados para el objeto actual RegionInfo.

Consulte también

• CultureInfo