RegionInfo RegionInfo RegionInfo RegionInfo Class

Definizione

Contiene le informazioni relative al paese.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
Ereditarietà
RegionInfoRegionInfoRegionInfoRegionInfo
Attributi

Esempi

L'esempio seguente illustra vari membri del RegionInfo classe.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
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 'Main

End Class 'SamplesRegionInfo 


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


Commenti

A differenza di CultureInfo (classe), il RegionInfo classe non rappresenta le preferenze dell'utente e non dipendono dal linguaggio o delle impostazioni cultura dell'utente.Unlike the CultureInfo class, the RegionInfo class does not represent user preferences and does not depend on the user's language or culture.

Nomi associati a un oggetto RegionInfoNames Associated with a RegionInfo Object

Il nome di un RegionInfo oggetto è uno dei codici a due lettere definiti in ISO 3166 per paese/area geografica.The name of a RegionInfo object is one of the two-letter codes defined in ISO 3166 for country/region. Caso non è significativo.Case is not significant. Il Name, TwoLetterISORegionName, e ThreeLetterISORegionName proprietà restituiscono i codici appropriati in lettere maiuscole.The Name, TwoLetterISORegionName, and ThreeLetterISORegionName properties return the appropriate codes in uppercase. Per l'elenco corrente di RegionInfo nomi, vedere inglese nomi di paesi e gli elementi di codice sul sito Web ISO.For the current list of RegionInfo names, see English country names and code elements on the ISO website.

Creare un'istanza di un oggetto RegionInfoInstantiating a RegionInfo Object

Creare un'istanza di un RegionInfo dell'oggetto, si passa il RegionInfo(String) costruttore entrambi un nome di area geografica di due lettere, ad esempio "US" per gli Stati Uniti o il nome delle impostazioni cultura specifiche, ad esempio "en-US" per inglese (Stati Uniti).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). Tuttavia, è consigliabile usare un nome di impostazioni cultura specifiche anziché un nome di area geografica di due lettere, perché un RegionInfo oggetto non è completamente indipendente dal linguaggio.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. Numerosi RegionInfo proprietà, tra cui DisplayName, NativeName, e CurrencyNativeName, dipendono da nomi di impostazioni cultura.Several RegionInfo properties, including DisplayName, NativeName, and CurrencyNativeName, depend on culture names.

Nell'esempio seguente viene illustrata la differenza in RegionInfo valori delle proprietà per tre oggetti che rappresentano Belgio.The following example illustrates the difference in RegionInfo property values for three objects that represent Belgium. La prima viene creata un'istanza di un nome di area (BE), solo mentre il secondo e terzo istanze vengono create dai nomi delle impostazioni cultura (fr-BE per francese (Belgio) e nl-BE per l'olandese (Belgio), rispettivamente).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). L'esempio Usa la reflection per recuperare i valori delle proprietà della ognuno RegionInfo oggetto.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

Negli scenari seguenti, utilizzare nomi delle impostazioni cultura anziché nomi di paese/area geografica quando crea un'istanza un RegionInfo oggetto:In scenarios such as the following, use culture names instead of country/region names when you instantiate a RegionInfo object:

  • Quando il nome della lingua è di primaria importanza.When the language name is of primary importance. Ad esempio, per il nome delle impostazioni cultura es-US, si sarà probabilmente necessario nell'applicazione viene visualizzato "Estados Unidos" anziché "Stati Uniti".For example, for the es-US culture name, you'll probably want your application to display "Estados Unidos" instead of "United States". Usando il nome di paese/area geografica (US) produce da solo "Stati Uniti" indipendentemente dalla lingua, quindi, dovrebbero funzionare con il nome delle impostazioni cultura invece.Using the country/region name (US) alone yields "United States" regardless of the language, so you should work with the culture name instead.

  • Quando è necessario considerare le differenze dello script.When script differences must be considered. Ad esempio, il paese/regione AZ riguarda le impostazioni cultura Azero che hanno nomi az-Latn-AZ e Cyrl-zone di disponibilità e l'alfabeto latino e cirillico script può essere molto diverso per il paese/area geografica.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.

  • Quando è importante conservare i dettagli.When maintenance of detail is important. I valori restituiti da RegionInfo i membri possono differire a seconda che il RegionInfo è stata creata un'istanza di oggetto utilizzando un nome delle impostazioni cultura o un nome di area.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. Ad esempio, la tabella seguente elenca le differenze in cambio valori quando un RegionInfo viene creata un'istanza di oggetto utilizzando l'area "Stati Uniti", le impostazioni cultura "en-US" e le impostazioni cultura "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.

    MemberMember "US""US" "en-US""en-US" "es-US""es-US"
    CurrencyNativeName Dollaro USAUS Dollar Dollaro USAUS Dollar Dólar de EE.UU.Dólar de EE.UU.
    Name USUS en-USen-US es-USes-US
    NativeName Stati UnitiUnited States Stati UnitiUnited States Estados UnidosEstados Unidos
    ToString USUS en-USen-US es-USes-US

Costruttori

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

Inizializza una nuova istanza della classe RegionInfo in base al paese associato all'identificatore di impostazioni cultura specificato.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)

Inizializza una nuova istanza della classe RegionInfo in base al paese o alle impostazioni cultura specifiche, specificato per nome.Initializes a new instance of the RegionInfo class based on the country/region or specific culture, specified by name.

Proprietà

CurrencyEnglishName CurrencyEnglishName CurrencyEnglishName CurrencyEnglishName

Ottiene il nome, in inglese, della valuta usata nel paese.Gets the name, in English, of the currency used in the country/region.

CurrencyNativeName CurrencyNativeName CurrencyNativeName CurrencyNativeName

Ottiene il nome della valuta utilizzata nel paese, formattato nella lingua nativa del paese.Gets the name of the currency used in the country/region, formatted in the native language of the country/region.

CurrencySymbol CurrencySymbol CurrencySymbol CurrencySymbol

Ottiene il simbolo di valuta associato al paese.Gets the currency symbol associated with the country/region.

CurrentRegion CurrentRegion CurrentRegion CurrentRegion

Ottiene l'oggetto RegionInfo che rappresenta il paese utilizzato dal thread corrente.Gets the RegionInfo that represents the country/region used by the current thread.

DisplayName DisplayName DisplayName DisplayName

Ottiene il nome completo del paese nella lingua della versione localizzata di .NET Framework.Gets the full name of the country/region in the language of the localized version of .NET Framework.

EnglishName EnglishName EnglishName EnglishName

Ottiene il nome completo del paese in lingua inglese.Gets the full name of the country/region in English.

GeoId GeoId GeoId GeoId

Ottiene un numero di identificazione univoco per un'area geografica, un paese, una città o una località.Gets a unique identification number for a geographical region, country, city, or location.

IsMetric IsMetric IsMetric IsMetric

Ottiene un valore che indica se nel paese in questione viene utilizzato il sistema metrico decimale per le misurazioni.Gets a value indicating whether the country/region uses the metric system for measurements.

ISOCurrencySymbol ISOCurrencySymbol ISOCurrencySymbol ISOCurrencySymbol

Ottiene il simbolo di valuta a tre lettere ISO 4217 associato al paese.Gets the three-character ISO 4217 currency symbol associated with the country/region.

Name Name Name Name

Ottiene il nome o il codice ISO 3166 a due lettere relativo al paese per l'oggetto RegionInfo corrente.Gets the name or ISO 3166 two-letter country/region code for the current RegionInfo object.

NativeName NativeName NativeName NativeName

Ottiene il nome del paese, formattato nella lingua nativa del paese.Gets the name of a country/region formatted in the native language of the country/region.

ThreeLetterISORegionName ThreeLetterISORegionName ThreeLetterISORegionName ThreeLetterISORegionName

Ottiene il codice a tre lettere definito in ISO 3166 per il paese.Gets the three-letter code defined in ISO 3166 for the country/region.

ThreeLetterWindowsRegionName ThreeLetterWindowsRegionName ThreeLetterWindowsRegionName ThreeLetterWindowsRegionName

Ottiene il codice a tre lettere assegnato da Windows al paese rappresentato da RegionInfo.Gets the three-letter code assigned by Windows to the country/region represented by this RegionInfo.

TwoLetterISORegionName TwoLetterISORegionName TwoLetterISORegionName TwoLetterISORegionName

Ottiene il codice a due lettere definito in ISO 3166 per il paese.Gets the two-letter code defined in ISO 3166 for the country/region.

Metodi

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

Determina se l'oggetto specificato coincide con l'istanza dell'oggetto RegionInfo corrente.Determines whether the specified object is the same instance as the current RegionInfo.

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

Viene utilizzato come funzione hash per l'oggetto RegionInfo corrente, adatto per algoritmi hash e strutture di dati, ad esempio una tabella 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()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

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

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

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

Restituisce una stringa contenente il nome delle impostazioni cultura o i codici ISO 3166 a due lettere relativi al paese specificati per la classe RegionInfo corrente.Returns a string containing the culture name or ISO 3166 two-letter country/region codes specified for the current RegionInfo.

Si applica a

Vedi anche