Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Classe RegionInfo

 

Contém informações sobre o país/região.

Namespace:   System.Globalization
Assembly:  mscorlib (em mscorlib.dll)

System.Object
  System.Globalization.RegionInfo

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

NomeDescrição
System_CAPS_pubmethodRegionInfo(Int32)

Inicializa uma nova instância de RegionInfo classe com base no país/região associado ao identificador de cultura especificada.

System_CAPS_pubmethodRegionInfo(String)

Inicializa uma nova instância de RegionInfo classe com base no país/região ou cultura específica, especificada pelo nome.

NomeDescrição
System_CAPS_pubpropertyCurrencyEnglishName

Obtém o nome em inglês, da moeda usada no país/região.

System_CAPS_pubpropertyCurrencyNativeName

Obtém o nome da moeda usada no país/região, formatado na linguagem nativa do país/região.

System_CAPS_pubpropertyCurrencySymbol

Obtém o símbolo de moeda associado ao país/região.

System_CAPS_pubpropertySystem_CAPS_staticCurrentRegion

Obtém o RegionInfo que representa o país/região usado pelo thread atual.

System_CAPS_pubpropertyDisplayName

Obtém o nome completo do país/região no idioma da versão localizada do .NET Framework.

System_CAPS_pubpropertyEnglishName

Obtém o nome completo do país/região em inglês.

System_CAPS_pubpropertyGeoId

Obtém um número de identificação exclusivo para uma região geográfica, país, cidade ou local.

System_CAPS_pubpropertyIsMetric

Obtém um valor que indica se o país/região usam o sistema métrico para medidas.

System_CAPS_pubpropertyISOCurrencySymbol

Obtém o símbolo de moeda três caracteres ISO 4217 associado ao país/região.

System_CAPS_pubpropertyName

Obtém o nome ou o código de país/região com duas letras da ISO 3166 atual RegionInfo objeto.

System_CAPS_pubpropertyNativeName

Obtém o nome de um país/região formatado na linguagem nativa do país/região.

System_CAPS_pubpropertyThreeLetterISORegionName

Obtém o código de três letras definido na ISO 3166 para o país/região.

System_CAPS_pubpropertyThreeLetterWindowsRegionName

Obtém o código de três letras atribuído pelo Windows para o país/região representado por este RegionInfo.

System_CAPS_pubpropertyTwoLetterISORegionName

Obtém o código de duas letras definido na ISO 3166 para o país/região.

NomeDescrição
System_CAPS_pubmethodEquals(Object)

Determina se o objeto especificado é a mesma instância do atual RegionInfo.(Substitui o Object.Equals(Object).)

System_CAPS_protmethodFinalize()

Permite que um objeto tente liberar recursos e executar outras operações de limpeza antes que ele seja recuperado pela coleta de lixo. (Herdado de Object.)

System_CAPS_pubmethodGetHashCode()

Serve como uma função de hash atual RegionInfo, adequados para o hash de algoritmos e estruturas de dados, como uma tabela de hash.(Substitui o Object.GetHashCode().)

System_CAPS_pubmethodGetType()

Obtém o Type da instância atual.(Herdado de Object.)

System_CAPS_protmethodMemberwiseClone()

Cria uma cópia superficial do Object atual.(Herdado de Object.)

System_CAPS_pubmethodToString()

Retorna uma cadeia de caracteres que contém o nome de cultura ou códigos de país/região com duas letras ISO 3166 especificados para a RegionInfo.(Substitui o Object.ToString().)

Unlike the T:System.Globalization.CultureInfo class, the T:System.Globalization.RegionInfo class does not represent user preferences and does not depend on the user's language or culture.

The name of a T:System.Globalization.RegionInfo object is one of the two-letter codes defined in ISO 3166 for country/region. Case is not significant. The P:System.Globalization.RegionInfo.Name, P:System.Globalization.RegionInfo.TwoLetterISORegionName, and P:System.Globalization.RegionInfo.ThreeLetterISORegionName properties return the appropriate codes in uppercase. For the current list of T:System.Globalization.RegionInfo names, see English country names and code elementshttp://go.microsoft.com/fwlink/?LinkId=190591 on the ISO website.

To instantiate a T:System.Globalization.RegionInfo object, you pass the M:System.Globalization.RegionInfo.#ctor(System.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). However, we recommend that you use a specific culture name instead of a two-letter region name, because a T:System.Globalization.RegionInfo object is not completely language-independent. Several T:System.Globalization.RegionInfo properties, including P:System.Globalization.RegionInfo.DisplayName, P:System.Globalization.RegionInfo.NativeName, and P:System.Globalization.RegionInfo.CurrencyNativeName, depend on culture names.

The following example illustrates the difference in T:System.Globalization.RegionInfo property values for three objects that represent Belgium. 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 and nl-BE for Dutch (Belgium), respectively). The example uses reflection to retrieve the property values of each T:System.Globalization.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

In scenarios such as the following, use culture names instead of country/region names when you instantiate a T:System.Globalization.RegionInfo object:

  • When the language name is of primary importance. For example, for the es-US culture name, you'll probably want your application to display "Estados Unidos" instead of "United States". Using the country/region name (US) alone yields "United States" regardless of the language, so you should work with the culture name instead.

  • When script differences must be considered. 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.

  • When maintenance of detail is important. The values returned by T:System.Globalization.RegionInfo members can differ depending on whether the T:System.Globalization.RegionInfo object was instantiated by using a culture name or a region name. For example, the following table lists the differences in return values when a T:System.Globalization.RegionInfo object is instantiated by using the "US" region, the "en-US" culture, and the "es-US" culture.

    Member

    "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

The following example demonstrates several members of the T:System.Globalization.RegionInfo class.

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 do Windows
Disponível desde 8
.NET Framework
Disponível desde 1.1
Biblioteca de Classes Portátil
Com suporte no: plataformas portáteis do .NET
Silverlight
Disponível desde 2.0
Windows Phone Silverlight
Disponível desde 7.0
Windows Phone
Disponível desde 8.1

Quaisquer membros estáticos públicos ( Compartilhado no Visual Basic) desse tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Retornar ao início
Mostrar: