RegionInfo Klasse

Definition

Enthält Informationen über das Land bzw. die Region.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
Vererbung
RegionInfo
Attribute

Beispiele

Im folgenden Beispiel werden mehrere Member der RegionInfo-Klasse veranschaulicht.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.


Hinweise

Im Gegensatz zur CultureInfo-Klasse stellt die RegionInfo-Klasse keine Benutzereinstellungen dar und ist nicht von der Sprache oder Kultur des Benutzers abhängig.Unlike the CultureInfo class, the RegionInfo class does not represent user preferences and does not depend on the user's language or culture.

Einem RegionInfo-Objekt zugeordnete NamenNames Associated with a RegionInfo Object

Der Name eines RegionInfo Objekts ist einer der aus zwei Buchstaben bestehenden Codes, die in ISO 3166 für Land/Region definiert sind.The name of a RegionInfo object is one of the two-letter codes defined in ISO 3166 for country/region. Der Fall ist nicht signifikant.Case is not significant. Die Eigenschaften Name, TwoLetterISORegionNameund ThreeLetterISORegionName geben die entsprechenden Codes in Großbuchstaben zurück.The Name, TwoLetterISORegionName, and ThreeLetterISORegionName properties return the appropriate codes in uppercase. Die aktuelle Liste der RegionInfo Namen finden Sie auf der ISO-Website unter englische Ländernamen und Code Elemente .For the current list of RegionInfo names, see English country names and code elements on the ISO website.

Instanziieren eines RegionInfo-ObjektsInstantiating a RegionInfo Object

Wenn Sie ein RegionInfo Objekt instanziieren möchten, übergeben Sie den RegionInfo(String)-Konstruktor entweder einen aus zwei Buchstaben bestehenden Regions Namen, z. b. "US" für die USA, oder den Namen einer bestimmten Kultur, z. b. "en-US" für Englisch (USA).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). Es wird jedoch empfohlen, anstelle eines aus zwei Buchstaben bestehenden Regions namens einen bestimmten Kultur Namen zu verwenden, da ein RegionInfo Objekt nicht vollständig sprachunabhängig ist.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. Mehrere RegionInfo Eigenschaften, einschließlich DisplayName, NativeNameund CurrencyNativeName, sind von Kultur Namen abhängig.Several RegionInfo properties, including DisplayName, NativeName, and CurrencyNativeName, depend on culture names.

Das folgende Beispiel veranschaulicht den Unterschied in RegionInfo Eigenschafts Werten für drei Objekte, die Belgien darstellen.The following example illustrates the difference in RegionInfo property values for three objects that represent Belgium. Der erste instanziiert von einem Regions Namen (ist), während das zweite und das dritte aus Kultur Namen instanziiert werden (FR-be für Französisch (Belgien) und NL-BE für Niederländisch (Belgien)).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). Das Beispiel verwendet Reflektion, um die Eigenschaftswerte der einzelnen RegionInfo-Objekte abzurufen.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

Verwenden Sie in Szenarien wie z. b. die folgenden Kultur Namen anstelle von Land-/Regionsnamen, wenn Sie ein RegionInfo Objekt instanziieren:In scenarios such as the following, use culture names instead of country/region names when you instantiate a RegionInfo object:

  • Wenn der Sprachen Name von größter Bedeutung ist.When the language name is of primary importance. Beispielsweise möchten Sie für den Namen der es-US-Kultur wahrscheinlich, dass Ihre Anwendung "Estados Unidos" anstelle von "USA" anzeigt.For example, for the es-US culture name, you'll probably want your application to display "Estados Unidos" instead of "United States". Die Verwendung des Landes-/regionsnamens (USA) allein führt zu "USA", unabhängig von der Sprache. Daher sollten Sie stattdessen mit dem Kultur Namen arbeiten.Using the country/region name (US) alone yields "United States" regardless of the language, so you should work with the culture name instead.

  • Wenn Skript Unterschiede berücksichtigt werden müssen.When script differences must be considered. Das Land/die Region az beschäftigt sich z. b. mit aserbaidschischen Kulturen, die die Namen AZ-Latn-AZ und az-Cyrl-AZ aufweisen, und die lateinischen und kyrillischen Skripts können sich für dieses Land bzw. diese Region stark unterscheiden.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.

  • Wenn die Wartung von Details wichtig ist.When maintenance of detail is important. Die von RegionInfo Membern zurückgegebenen Werte können abhängig davon variieren, ob das RegionInfo Objekt mithilfe eines Kultur namens oder eines Regions namens instanziiert wurde.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. In der folgenden Tabelle sind z. b. die Unterschiede in den Rückgabe Werten aufgeführt, wenn ein RegionInfo Objekt mit der Kultur "US", der Kultur "en-US" und der Kultur "es-US" instanziiert wird.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 Vorliegenden"US" "en-US""en-US" "es-US""es-US"
    CurrencyNativeName US-DollarUS Dollar US-DollarUS Dollar Dólar de EE.UU.Dólar de EE.UU.
    Name USUS en-USen-US es-USes-US
    NativeName USAUnited States USAUnited States Estados UnidosEstados Unidos
    ToString USUS en-USen-US es-USes-US

Konstruktoren

RegionInfo(Int32)

Initialisiert eine neue Instanz der RegionInfo-Klasse auf der Grundlage des Landes oder der Region, das bzw. die dem angegebenen Kulturbezeichner zugeordnet ist.Initializes a new instance of the RegionInfo class based on the country/region associated with the specified culture identifier.

RegionInfo(String)

Initialisiert eine neue Instanz der RegionInfo-Klasse auf der Grundlage des Landes oder der Region bzw. einer bestimmten Kultur, dessen bzw. deren Name angegeben ist.Initializes a new instance of the RegionInfo class based on the country/region or specific culture, specified by name.

Eigenschaften

CurrencyEnglishName

Ruft den Namen der in diesem Land oder dieser Region verwendeten Währung auf Englisch ab.Gets the name, in English, of the currency used in the country/region.

CurrencyNativeName

Ruft den Namen der in diesem Land oder dieser Region verwendeten Währung im systemeigenen Sprachformat des Lands oder der Region ab.Gets the name of the currency used in the country/region, formatted in the native language of the country/region.

CurrencySymbol

Ruft das dem Land bzw. der Region zugeordnete Währungssymbol ab.Gets the currency symbol associated with the country/region.

CurrentRegion

Ruft die RegionInfo ab, die das vom aktuellen Thread verwendete Land oder die Region darstellt.Gets the RegionInfo that represents the country/region used by the current thread.

DisplayName

Ruft den vollständigen Namen des Landes bzw. der Region in der Sprache der lokalisierten Version von .NET Framework ab.Gets the full name of the country/region in the language of the localized version of .NET Framework.

EnglishName

Ruft den vollständigen Namen des Landes bzw. der Region in Englisch ab.Gets the full name of the country/region in English.

GeoId

Ruft eine eindeutige Identifikationsnummer für eine geographische Region, ein Land, eine Stadt oder einen Ort ab.Gets a unique identification number for a geographical region, country, city, or location.

IsMetric

Ruft einen Wert ab, der angibt, ob in dem Land bzw. der Region für Maßeinheiten das metrische System verwendet wird.Gets a value indicating whether the country/region uses the metric system for measurements.

ISOCurrencySymbol

Ruft das aus drei Zeichen bestehende, dem Land bzw. der Region nach ISO 4217 zugeordnete Währungssymbol ab.Gets the three-character ISO 4217 currency symbol associated with the country/region.

Name

Ruft den Namen oder den aus zwei Buchstaben bestehenden Code für das Land oder die Region gemäß ISO 3166 für das aktuelle RegionInfo-Objekt ab.Gets the name or ISO 3166 two-letter country/region code for the current RegionInfo object.

NativeName

Ruft den Namen eines Lands oder einer Region in der systemeigenen Sprache des Lands oder der Region ab.Gets the name of a country/region formatted in the native language of the country/region.

ThreeLetterISORegionName

Ruft den in ISO 3166 definierten, aus drei Buchstaben bestehenden Code für das Land bzw. die Region ab.Gets the three-letter code defined in ISO 3166 for the country/region.

ThreeLetterWindowsRegionName

Ruft den aus drei Buchstaben bestehenden Code ab, der von Windows dem Land oder der Region zugeordnet wird, das bzw. die durch die RegionInfo dargestellt wird.Gets the three-letter code assigned by Windows to the country/region represented by this RegionInfo.

TwoLetterISORegionName

Ruft den in ISO 3166 definierten, aus zwei Buchstaben bestehenden Code für das Land oder die Region ab.Gets the two-letter code defined in ISO 3166 for the country/region.

Methoden

Equals(Object)

Bestimmt, ob es sich bei dem angegebenen Objekt um dieselbe Instanz handelt wie die aktuelle RegionInfo-Klasse.Determines whether the specified object is the same instance as the current RegionInfo.

GetHashCode()

Fungiert als Hashfunktion für die aktuelle RegionInfo, die sich für die Verwendung in Hashalgorithmen und -datenstrukturen eignet, z. B. in einer Hashtabelle.Serves as a hash function for the current RegionInfo, suitable for hashing algorithms and data structures, such as a hash table.

GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die den Kulturnamen oder den aus zwei Buchstaben bestehenden Code nach ISO 1366 für das Land oder die Region für die aktuelle RegionInfo enthält.Returns a string containing the culture name or ISO 3166 two-letter country/region codes specified for the current RegionInfo.

Gilt für:

Siehe auch