RegionInfo RegionInfo RegionInfo RegionInfo Class

Definición

Contiene información sobre el país o la región.Contains information about the country/region.

public ref class RegionInfo
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public class RegionInfo
type RegionInfo = class
Public Class RegionInfo
Herencia
RegionInfoRegionInfoRegionInfoRegionInfo
Atributos

Ejemplos

En el ejemplo siguiente se muestran varios miembros RegionInfo de la clase.The following 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.

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

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

End Class


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


Comentarios

A diferencia de CultureInfo la clase, RegionInfo la clase no representa las preferencias del usuario y no depende del idioma o la referencia cultural del usuario.Unlike the CultureInfo class, the RegionInfo class does not represent user preferences and does not depend on the user's language or culture.

Nombres asociados a un objeto RegionInfoNames Associated with a RegionInfo Object

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.The name of a RegionInfo object is one of the two-letter codes defined in ISO 3166 for country/region. El caso no es significativo.Case is not significant. Las Namepropiedades TwoLetterISORegionName, yThreeLetterISORegionName devuelven los códigos correspondientes en mayúsculas.The Name, TwoLetterISORegionName, and ThreeLetterISORegionName properties return the appropriate codes in uppercase. Para obtener la lista actual RegionInfo de nombres, consulte nombres de país y elementos de código en inglés en el sitio web ISO.For the current list of RegionInfo names, see English country names and code elements on the ISO website.

Crear instancias de un objeto RegionInfoInstantiating a RegionInfo Object

Para crear una instancia RegionInfo de un objeto, se RegionInfo(String) pasa al constructor un nombre de región de dos letras, como "US" para el Estados Unidos, o el nombre de una referencia cultural concreta, como "en-US" para inglés (Estados Unidos).To instantiate a RegionInfo object, you pass the RegionInfo(String) constructor either a two-letter region name, such as "US" for the United States, or the name of a specific culture, such as "en-US" for English (United States). Sin embargo, se recomienda usar un nombre de referencia cultural específico en lugar de un nombre de región de dos letras, RegionInfo ya que un objeto no es totalmente independiente del lenguaje.However, we recommend that you use a specific culture name instead of a two-letter region name, because a RegionInfo object is not completely language-independent. Varias RegionInfo propiedades, como DisplayName, NativeNamey CurrencyNativeName, dependen de los nombres de la referencia cultural.Several RegionInfo properties, including DisplayName, NativeName, and CurrencyNativeName, depend on culture names.

En el ejemplo siguiente se muestra la diferencia RegionInfo en los valores de propiedad de tres objetos que representan Bélgica.The following example illustrates the difference in RegionInfo property values for three objects that represent Belgium. La primera instancia solo se crea desde un nombre de región (ser), mientras que la segunda y la tercera se crean a partir de los nombres de las referencias culturales (fr-is para francés (Bélgica) y nl-is para holandés (Bélgica), respectivamente).The first is instantiated from a region name (BE) only, while the second and third are instantiated from culture names (fr-BE for French (Belgium) and nl-BE for Dutch (Belgium), respectively). En el ejemplo se usa la reflexión para recuperar los valores RegionInfo de propiedad de cada objeto.The example uses reflection to retrieve the property values of each RegionInfo object.

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
Imports System.Globalization
Imports System.Reflection

Module Example
   Public Sub Main()
      ' Instantiate three Belgian RegionInfo objects.
      Dim BE As New RegionInfo("BE")
      Dim frBE As New RegionInfo("fr-BE")
      Dim nlBE As New RegionInfo("nl-BE")

      Dim regions() As RegionInfo = { BE, frBE, nlBE }
      Dim props() As PropertyInfo = GetType(RegionInfo).GetProperties(BindingFlags.Instance Or BindingFlags.Public)
      
      Console.WriteLine("{0,-30}{1,18}{2,18}{3,18}", 
                        "RegionInfo Property", "BE", "fr-BE", "nl-BE")
      Console.WriteLine()
      For Each prop As PropertyInfo In props
         Console.Write("{0,-30}", prop.Name)
         For Each region In regions
            Console.Write("{0,18}", prop.GetValue(region, Nothing))
         Next
         Console.WriteLine()
      Next
   End Sub
End Module
' 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 cuando cree una RegionInfo instancia de un objeto:In scenarios such as the following, use culture names instead of country/region names when you instantiate a RegionInfo object:

  • Cuando el nombre de idioma es de importancia principal.When the language name is of primary importance. Por ejemplo, para el nombre de la referencia cultural es-US, es probable que desee que la aplicación muestre "Estados Unidos" en lugar de "Estados Unidos".For example, for the es-US culture name, you'll probably want your application to display "Estados Unidos" instead of "United States". El uso del nombre de país o región (EE. UU.) solo produce "Estados Unidos" independientemente del idioma, por lo que debe trabajar con el nombre de la referencia cultural en su lugar.Using the country/region name (US) alone yields "United States" regardless of the language, so you should work with the culture name instead.

  • Cuándo se deben tener en cuenta las diferencias en el script.When script differences must be considered. Por ejemplo, el país o la región AZ trata las referencias culturales de azerbaiyano que tienen los nombres AZ-latn-AZ y AZ-Cyrl-AZ, y los scripts Latin y cirílico pueden ser muy diferentes para este país o región.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.

  • Cuando el mantenimiento de los detalles es importante.When maintenance of detail is important. Los valores devueltos por RegionInfo los miembros pueden diferir dependiendo de si se ha creado una instancia del RegionInfo objeto mediante un nombre de referencia cultural o un nombre de región.The values returned by RegionInfo members can differ depending on whether the RegionInfo object was instantiated by using a culture name or a region name. Por ejemplo, en la tabla siguiente se enumeran las diferencias en los RegionInfo valores devueltos cuando se crea una instancia de un objeto mediante la región "US", la referencia cultural "en-US" y la referencia cultural "es-US".For example, the following table lists the differences in return values when a RegionInfo object is instantiated by using the "US" region, the "en-US" culture, and the "es-US" culture.

    MiembroMember INDÍQUE"US" "en-US""en-US" "es-US""es-US"
    CurrencyNativeName Dólar estadounidenseUS Dollar Dólar estadounidenseUS Dollar Dólar de EE. UU.Dólar de EE.UU.
    Name USUS en-USen-US es-USes-US
    NativeName Estados UnidosUnited States Estados UnidosUnited States Estados UnidosEstados Unidos
    ToString USUS en-USen-US es-USes-US

Constructores

RegionInfo(Int32) RegionInfo(Int32) RegionInfo(Int32) RegionInfo(Int32)

Inicializa una nueva instancia de la clase RegionInfo de acuerdo con el país o región asociados a la referencia cultural especificada.Initializes a new instance of the RegionInfo class based on the country/region associated with the specified culture identifier.

RegionInfo(String) RegionInfo(String) RegionInfo(String) RegionInfo(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.Initializes a new instance of the RegionInfo class based on the country/region or specific culture, specified by name.

Propiedades

CurrencyEnglishName CurrencyEnglishName CurrencyEnglishName CurrencyEnglishName

Obtiene el nombre, en inglés, de la moneda utilizada en el país o región.Gets the name, in English, of the currency used in the country/region.

CurrencyNativeName CurrencyNativeName CurrencyNativeName CurrencyNativeName

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.Gets the name of the currency used in the country/region, formatted in the native language of the country/region.

CurrencySymbol CurrencySymbol CurrencySymbol CurrencySymbol

Obtiene el símbolo de divisa asociado al país o región.Gets the currency symbol associated with the country/region.

CurrentRegion CurrentRegion CurrentRegion CurrentRegion

Obtiene el RegionInfo que representa el país o región utilizado por el subproceso actual.Gets the RegionInfo that represents the country/region used by the current thread.

DisplayName DisplayName DisplayName DisplayName

Obtiene el nombre completo del país o región en el idioma de la versión traducida de .NET Framework.Gets the full name of the country/region in the language of the localized version of .NET Framework.

EnglishName EnglishName EnglishName EnglishName

Obtiene el nombre completo del país o región en inglés.Gets the full name of the country/region in English.

GeoId GeoId GeoId GeoId

Obtiene un número de identificación único para una región, país, ciudad o ubicación geográfica.Gets a unique identification number for a geographical region, country, city, or location.

IsMetric IsMetric IsMetric IsMetric

Obtiene un valor que indica si el país o la región utilizan el sistema métrico para las medidas.Gets a value indicating whether the country/region uses the metric system for measurements.

ISOCurrencySymbol ISOCurrencySymbol ISOCurrencySymbol ISOCurrencySymbol

Obtiene el símbolo de divisa ISO 4217 de tres caracteres asociado al país o región.Gets the three-character ISO 4217 currency symbol associated with the country/region.

Name Name Name Name

Obtiene el nombre o el código de país o región de dos letras ISO 3166 para el objeto RegionInfo actual.Gets the name or ISO 3166 two-letter country/region code for the current RegionInfo object.

NativeName NativeName NativeName NativeName

Obtiene el nombre de un país o región, con el formato del idioma nativo del país o región.Gets the name of a country/region formatted in the native language of the country/region.

ThreeLetterISORegionName ThreeLetterISORegionName ThreeLetterISORegionName ThreeLetterISORegionName

Obtiene el código de tres letras definido en ISO 3166 para el país o región.Gets the three-letter code defined in ISO 3166 for the country/region.

ThreeLetterWindowsRegionName ThreeLetterWindowsRegionName ThreeLetterWindowsRegionName ThreeLetterWindowsRegionName

Obtiene el código de tres letras asignado por Windows al país o región representado por este RegionInfo.Gets the three-letter code assigned by Windows to the country/region represented by this RegionInfo.

TwoLetterISORegionName TwoLetterISORegionName TwoLetterISORegionName TwoLetterISORegionName

Obtiene el código de dos letras definido en ISO 3166 para el país o región.Gets the two-letter code defined in ISO 3166 for the country/region.

Métodos

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es la misma instancia que la RegionInfo actual.Determines whether the specified object is the same instance as the current RegionInfo.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como función hash para la RegionInfo actual, que se puede usar en algoritmos hash y estructuras de datos, como una tabla hash.Serves as a hash function for the current RegionInfo, suitable for hashing algorithms and data structures, such as a hash table.

GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

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.Returns a string containing the culture name or ISO 3166 two-letter country/region codes specified for the current RegionInfo.

Se aplica a

Consulte también: