RegionInfo Classe

Définition

Contient des informations sur le pays/région.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
Héritage
RegionInfo
Attributs

Exemples

L’exemple suivant illustre plusieurs membres de la classe RegionInfo.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.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

End Class


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


Remarques

Contrairement à la classe CultureInfo, la classe RegionInfo ne représente pas les préférences de l’utilisateur et ne dépend pas de la langue ou de la culture de l’utilisateur.Unlike the CultureInfo class, the RegionInfo class does not represent user preferences and does not depend on the user's language or culture.

Noms associés à un objet RegionInfoNames Associated with a RegionInfo Object

Le nom d’un objet RegionInfo est l’un des codes à deux lettres définis dans la norme ISO 3166 pour le pays/la région.The name of a RegionInfo object is one of the two-letter codes defined in ISO 3166 for country/region. La casse n’est pas significative.Case is not significant. Les propriétés Name, TwoLetterISORegionNameet ThreeLetterISORegionName renvoient les codes appropriés en majuscules.The Name, TwoLetterISORegionName, and ThreeLetterISORegionName properties return the appropriate codes in uppercase. Pour obtenir la liste actuelle des noms de RegionInfo, consultez noms de pays en anglais et éléments de code sur le site Web ISO.For the current list of RegionInfo names, see English country names and code elements on the ISO website.

Instanciation d’un objet RegionInfoInstantiating a RegionInfo Object

Pour instancier un objet RegionInfo, vous devez passer le constructeur RegionInfo(String) soit un nom de région à deux lettres, par exemple « US » pour le États-Unis, soit le nom d’une culture spécifique, tel que « en-US » pour l’anglais (États-Unis).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). Toutefois, nous vous recommandons d’utiliser un nom de culture spécifique au lieu d’un nom de région à deux lettres, car un objet RegionInfo n’est pas totalement indépendant de la langue.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. Plusieurs propriétés de RegionInfo, notamment DisplayName, NativeNameet CurrencyNativeName, dépendent des noms de culture.Several RegionInfo properties, including DisplayName, NativeName, and CurrencyNativeName, depend on culture names.

L’exemple suivant illustre la différence de RegionInfo des valeurs de propriété pour trois objets qui représentent la Belgique.The following example illustrates the difference in RegionInfo property values for three objects that represent Belgium. Le premier est instancié à partir d’un nom de région (uniquement), tandis que le deuxième et le troisième sont instanciés à partir des noms de culture (fr-is pour le français (Belgique) et NL-est pour le néerlandais (Belgique), respectivement).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’exemple utilise la réflexion pour récupérer les valeurs de propriété de chaque objet RegionInfo.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

Dans les scénarios tels que les suivants, utilisez des noms de culture au lieu de noms de pays/région quand vous instanciez un objet RegionInfo :In scenarios such as the following, use culture names instead of country/region names when you instantiate a RegionInfo object:

  • Lorsque le nom de la langue est l’importance principale.When the language name is of primary importance. Par exemple, pour le nom de culture es-US, vous souhaiterez probablement que votre application affiche « Estados Unidos » au lieu de « États-Unis ».For example, for the es-US culture name, you'll probably want your application to display "Estados Unidos" instead of "United States". L’utilisation du nom de pays/région (US) seul génère « États-Unis », quelle que soit la langue. vous devez donc utiliser le nom de la culture à la place.Using the country/region name (US) alone yields "United States" regardless of the language, so you should work with the culture name instead.

  • Lorsque les différences de script doivent être prises en compte.When script differences must be considered. Par exemple, le pays ou la région AZ traite les cultures azerbaïdjanais qui ont les noms az-Latn-AZ et az-Cyrl-AZ, et les scripts latin et cyrillique peuvent être très différents pour ce pays/cette région.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.

  • Lorsque la maintenance des détails est importante.When maintenance of detail is important. Les valeurs retournées par RegionInfo membres peuvent différer selon que l’objet RegionInfo a été instancié à l’aide d’un nom de culture ou d’un nom de région.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. Par exemple, le tableau suivant répertorie les différences dans les valeurs de retour lorsqu’un objet RegionInfo est instancié à l’aide de la région « États-Unis », de la culture « en-US » et de la culture « 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.

    MembreMember AIDÉ"US" « en-US »"en-US" « es-US »"es-US"
    CurrencyNativeName Dollar américainUS Dollar Dollar américainUS Dollar Dólar de l’EE. UU.Dólar de EE.UU.
    Name USUS en-USen-US es-USes-US
    NativeName États-UnisUnited States États-UnisUnited States Estados UnidosEstados Unidos
    ToString USUS en-USen-US es-USes-US

Constructeurs

RegionInfo(Int32)

Initialise une nouvelle instance de la classe RegionInfo basée sur le pays ou la région associé à l’identificateur de culture spécifié.Initializes a new instance of the RegionInfo class based on the country/region associated with the specified culture identifier.

RegionInfo(String)

Initialise une nouvelle instance de la classe RegionInfo basée sur le nom du pays ou de la région ou sur le nom de la culture spécifique.Initializes a new instance of the RegionInfo class based on the country/region or specific culture, specified by name.

Propriétés

CurrencyEnglishName

Obtient le nom en anglais de la devise utilisée dans le pays/région.Gets the name, in English, of the currency used in the country/region.

CurrencyNativeName

Obtient le nom de la devise utilisée dans le pays ou la région, mis en forme dans la langue native du pays ou de la région.Gets the name of the currency used in the country/region, formatted in the native language of the country/region.

CurrencySymbol

Obtient le symbole de devise associé au pays/région.Gets the currency symbol associated with the country/region.

CurrentRegion

Obtient le RegionInfo qui représente le pays ou la région utilisé par le thread actuel.Gets the RegionInfo that represents the country/region used by the current thread.

DisplayName

Obtient le nom complet du pays ou de la région dans la langue de la version localisée du .NET Framework.Gets the full name of the country/region in the language of the localized version of .NET Framework.

EnglishName

Obtient le nom complet du pays ou de la région en anglais.Gets the full name of the country/region in English.

GeoId

Obtient un numéro d'identification unique pour une région géographique, un pays, une ville ou un emplacement.Gets a unique identification number for a geographical region, country, city, or location.

IsMetric

Obtient une valeur indiquant si le pays ou la région utilise le système métrique pour les mesures.Gets a value indicating whether the country/region uses the metric system for measurements.

ISOCurrencySymbol

Obtient le symbole de devise ISO 4217 sur trois caractères associé au pays/région.Gets the three-character ISO 4217 currency symbol associated with the country/region.

Name

Obtient le nom ou le code de pays/région ISO 3166 à deux lettres pour l’objet RegionInfo actuel.Gets the name or ISO 3166 two-letter country/region code for the current RegionInfo object.

NativeName

Obtient le nom d'un pays/région mis en forme dans la langue native du pays/région.Gets the name of a country/region formatted in the native language of the country/region.

ThreeLetterISORegionName

Obtient le code à trois lettres défini dans ISO 3166 pour le pays/région.Gets the three-letter code defined in ISO 3166 for the country/region.

ThreeLetterWindowsRegionName

Obtient le code à trois lettres affecté par Windows au pays/région représenté par cet élément RegionInfo.Gets the three-letter code assigned by Windows to the country/region represented by this RegionInfo.

TwoLetterISORegionName

Obtient le code à deux lettres défini dans ISO 3166 pour le pays/région.Gets the two-letter code defined in ISO 3166 for the country/region.

Méthodes

Equals(Object)

Détermine si l’objet spécifié est la même instance que l’élément RegionInfo actuel.Determines whether the specified object is the same instance as the current RegionInfo.

GetHashCode()

Est utilisé comme fonction de hachage pour l'élément RegionInfo actuel, et convient aux algorithmes de hachage et aux structures de données, comme une table de hachage.Serves as a hash function for the current RegionInfo, suitable for hashing algorithms and data structures, such as a hash table.

GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
ToString()

Retourne une chaîne contenant le nom de culture ou les codes de pays/région ISO 3166 à deux lettres pour l’élément RegionInfo actuel.Returns a string containing the culture name or ISO 3166 two-letter country/region codes specified for the current RegionInfo.

S’applique à

Voir aussi