RegionInfo Classe

Definição

Espaço de Nomes:

System.Globalization

Assemblagens:

netstandard.dll, System.Runtime.dll

Origem:

RegionInfo.cs

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

public ref class RegionInfo

public class RegionInfo

type RegionInfo = class

Public Class RegionInfo

Herança

Object

RegionInfo

Observações

Ao contrário da CultureInfo classe, a classe não representa as RegionInfo preferências do usuário e não depende do idioma ou da cultura do usuário.

Nomes associados a um objeto RegionInfo

O nome de um RegionInfo objeto é um dos códigos de duas letras definidos na ISO 3166 para país/região. O caso não é significativo. Name, TwoLetterISORegionName e ThreeLetterISORegionName retornam os códigos apropriados em maiúsculas. Para obter a lista atual de RegionInfo de país.

Instanciar um objeto RegionInfo

Para instanciar um RegionInfo objeto, passe ao RegionInfo(String) construtor um nome de região de duas letras, como "US" para os Estados Unidos, ou o nome de uma cultura específica, como "en-US" para inglês (Estados Unidos). No entanto, recomendamos que você use um nome de cultura específico em vez de um nome de região de duas letras, porque um RegionInfo objeto não é completamente independente do idioma. Várias RegionInfo propriedades, incluindo DisplayName, NativeName, e CurrencyNativeName, dependem de nomes de cultura.

O exemplo a seguir ilustra a diferença nos RegionInfo valores de propriedade para três objetos que representam a Bélgica. O primeiro é instanciado a partir de um nome de região (BE) apenas, enquanto o segundo e o terceiro são instanciados a partir de nomes de cultura (fr-BE para francês (Bélgica) e nl-BE para holandês (Bélgica), respectivamente). O exemplo usa reflexão para recuperar os valores de propriedade 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

Em cenários como os seguintes, use nomes de cultura em vez de nomes de país/região ao instanciar um RegionInfo objeto:

• Quando o nome da língua é de importância primordial. Por exemplo, para o nome da es-US cultura, você provavelmente desejará que seu aplicativo exiba "Estados Unidos" em vez de "Estados Unidos". Usar apenas o nome do país/região (US) produz "Estados Unidos" independentemente do idioma, portanto, você deve trabalhar com o nome da cultura.

• Quando as diferenças de script devem ser consideradas. Por exemplo, o país/região AZ lida com culturas do Azerbaijão que têm os nomes az-Latn-AZ e az-Cyrl-AZ, e as escritas latina e cirílica podem ser muito diferentes para este país/região.

• Quando a manutenção do detalhe é importante. Os valores retornados pelos RegionInfo membros podem diferir dependendo se o RegionInfo objeto foi instanciado usando um nome de cultura ou um nome de região. Por exemplo, a tabela a seguir lista as diferenças nos valores de retorno quando um RegionInfo objeto é instanciado usando a região "EUA", a cultura "en-US" e a cultura "es-US".

  Membro	"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":::

Construtores

Name	Descrição
RegionInfo(Int32)	Inicializa uma nova instância da RegionInfo classe com base no país/região associada ao identificador de cultura especificado.
RegionInfo(String)	Inicializa uma nova instância da RegionInfo classe com base no país/região ou cultura específica, especificada pelo nome.

Propriedades

Name	Descrição
CurrencyEnglishName	Recebe o nome, em inglês, da moeda usada no país/região.
CurrencyNativeName	Obtém o nome da moeda usada no país/região, formatado na língua nativa do país/região.
CurrencySymbol	Obtém o símbolo da moeda associado ao país/região.
CurrentRegion	Obtém o RegionInfo que representa o país/região usado pelo tópico atual.
DisplayName	Obtém o nome completo do país/região na língua da versão localizada do .NET.
EnglishName	Obtém o nome completo do país/região em inglês.
GeoId	Obtém um número de identificação único para uma região geográfica, país, cidade ou localização.
IsMetric	Recebe um valor que indica se o país/região utiliza o sistema métrico para medições.
ISOCurrencySymbol	Recebe o símbolo de moeda ISO 4217 de três caracteres associado ao país/região.
Name	Recebe o nome ou o código de país/região de duas letras ISO 3166 para o objeto atual RegionInfo .
NativeName	Recebe o nome de um país/região formatado na língua nativa do país/região.
ThreeLetterISORegionName	Recebe o código de três letras definido na ISO 3166 para o país/região.
ThreeLetterWindowsRegionName	Recebe o código de três letras atribuído por Windows ao país/região representado por este RegionInfo.
TwoLetterISORegionName	Recebe o código de duas letras definido na ISO 3166 para o país/região.

Métodos

Name	Descrição
Equals(Object)	Determina se o objeto especificado é a mesma instância que o atual RegionInfo.
GetHashCode()	Serve como função de hash para o atual RegionInfo, adequado para algoritmos de hash e estruturas de dados, como uma tabela de hash.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do atual Object. (Herdado de Object)
ToString()	Devolve uma cadeia contendo o nome da cultura ou códigos de país/região de duas letras ISO 3166 especificados para o atual RegionInfo.

Ver também

• CultureInfo