RegionInfo Classe

Definizione

public ref class RegionInfo

public class RegionInfo

[System.Serializable]
public class RegionInfo

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class RegionInfo

type RegionInfo = class

[<System.Serializable>]
type RegionInfo = class

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type RegionInfo = class

Public Class RegionInfo

Ereditarietà

Object

RegionInfo

Attributi

SerializableAttribute ComVisibleAttribute

Commenti

A differenza della CultureInfo classe , la RegionInfo classe non rappresenta le preferenze utente e non dipende dalla lingua o dalle impostazioni cultura dell'utente.

Nomi associati a un oggetto RegionInfo

Il nome di un RegionInfo oggetto è uno dei codici a due lettere definiti in ISO 3166 per paese/area geografica. Il caso non è significativo. Le proprietà Name, TwoLetterISORegionName e ThreeLetterISORegionName restituiscono i codici appropriati in lettere maiuscole. Per l'elenco corrente dei RegionInfo nomi, vedere ISO 3166: Codici paese.

Creare un'istanza di un oggetto RegionInfo

Per creare un'istanza di un oggetto RegionInfo, passare al costruttore RegionInfo(String) un nome di regione a due lettere, ad esempio "US" per gli Stati Uniti, o il nome di una cultura specifica, ad esempio "en-US" per l'inglese (Stati Uniti). È tuttavia consigliabile utilizzare un nome di cultura specifico anziché un nome di area geografica a due lettere, perché un oggetto RegionInfo non è completamente indipendente dalla lingua. Diverse RegionInfo proprietà, tra cui DisplayName, NativeName, e CurrencyNativeName, dipendono dai nomi delle culture.

Nell'esempio seguente viene illustrata la differenza nei valori delle RegionInfo proprietà per tre oggetti che rappresentano il Belgio. La prima è un'istanza creata solo da un nome di area (BE), mentre la seconda e la terza sono istanziate rispettivamente dai nomi di cultura (fr-BE per il francese (Belgio) e nl-BE per l'olandese (Belgio). Nell'esempio viene utilizzata la reflection per recuperare i valori delle proprietà di ogni RegionInfo oggetto.

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

Negli scenari come i seguenti, usa i nomi cultura anziché i nomi di paese/regione quando si crea un'istanza di un oggetto RegionInfo:

• Quando il nome della lingua è di importanza primaria. Ad esempio, è probabile che l'applicazione visualizzi "Estados Unidos" anziché "Stati Uniti" per il nome della cultura es-US. L'uso del nome del paese o del territorio (US) da solo restituisce "Stati Uniti" indipendentemente dalla lingua, quindi è consigliabile usare il nome della cultura.

• Quando è necessario considerare le differenze di script. Ad esempio, il paese/regione AZ si occupa delle culture azere con i nomi az-Latn-AZ e az-Cyrl-AZ, e gli alfabeti latino e cirillico possono essere molto diversi per questo paese/regione.

• Quando la manutenzione dei dettagli è importante. I valori restituiti dai membri RegionInfo possono variare a seconda che l'oggetto RegionInfo sia stato istanziato usando un nome cultura o un nome area. Ad esempio, nella tabella seguente sono elencate le differenze nei valori di ritorno quando viene creata un'istanza di un oggetto RegionInfo usando la cultura "Stati Uniti", la cultura "en-US" e la 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":::

Vedi anche

• CultureInfo