RegionInfo (Clase)

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

Cuando sea posible, debería utilizar los nombres de referencia cultural concretos, por ejemplo "en-US" para inglés (Estados Unidos), al crear instancias de un objeto RegionInfo. Puede utilizar simplemente un nombre de país/región, tal 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 de referencia cultural tanto para idioma como para el país o región. He aquí algunos escenarios en los que se deben utilizar los nombres de la referencia cultural en lugar de los nombres de país/región:

• Cuando 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 de la referencia cultural en lugar del nombre del país o región solo, que produce "United States" independientemente del idioma.

• Cuando se deben tener en cuenta las diferencias de script. Por ejemplo, el país o región "AZ" está relacionado con las referencias culturales azerí 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.

• Cuando es importante mantener los detalles. Para una referencia cultural concreta como inglés (Estados Unidos), denominada "en-us", su aplicación puede perder información importante si intenta crear un nuevo objeto RegionInfo a partir de simplemente el nombre de país/región "EE.UU.".

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

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.

*/

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

Referencia