RegionInfo Klasse

Definition

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

Vererbung

Object

RegionInfo

Attribute

SerializableAttribute ComVisibleAttribute

Hinweise

CultureInfo Im Gegensatz zur Klasse stellt die RegionInfo Klasse keine Benutzereinstellungen dar und hängt nicht von der Sprache oder Kultur des Benutzers ab.

Einem RegionInfo-Objekt zugeordnete Namen

Der Name eines RegionInfo Objekts ist einer der in ISO 3166 für Land/Region definierten zwei buchstabenigen Codes. Der Fall ist nicht bedeutend. Die Eigenschaften Name, TwoLetterISORegionName und ThreeLetterISORegionName geben die entsprechenden Codes in Großbuchstaben zurück. Die aktuelle Liste der RegionInfo Namen finden Sie unter ISO 3166: Ländercodes.

Instanziieren eines RegionInfo-Objekts

Um ein RegionInfo Objekt zu instanziieren, übergeben Sie den RegionInfo(String) Konstruktor entweder einen Zwei-Buchstaben-Regionsnamen, z. B. "US" für die Vereinigten Staaten, oder den Namen einer bestimmten Kultur, z. B. "en-US" für Englisch (USA). Es wird jedoch empfohlen, einen bestimmten Kulturnamen anstelle eines Zwei-Buchstaben-Regionsnamens zu verwenden, da ein RegionInfo Objekt nicht vollständig sprachunabhängig ist. Mehrere RegionInfo Eigenschaften, einschließlich DisplayName, NativeNameund CurrencyNativeName, hängen von Kulturnamen ab.

Im folgenden Beispiel wird der Unterschied bei RegionInfo Eigenschaftswerten für drei Objekte veranschaulicht, die Belgien darstellen. Der erste wird nur von einem Regionsnamen (BE) instanziiert, während das zweite und dritte aus den Kulturnamen (fr-BE für Französisch (Belgien) bzw nl-BE . für Niederländisch (Belgien) instanziiert werden. Das Beispiel verwendet Spiegelung, um die Eigenschaftswerte der einzelnen RegionInfo Objekte abzurufen.

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

Verwenden Sie in Szenarien wie den folgenden Kulturnamen anstelle von Landes-/Regionsnamen, wenn Sie ein RegionInfo Objekt instanziieren:

• Wenn der Sprachname von primärer Bedeutung ist. Für den Namen der Kultur es-US soll Ihre Anwendung wahrscheinlich "Estados Unidos" und nicht "Vereinigte Staaten" anzeigen. Die Verwendung des Landes-/Regionsnamens (US) allein führt unabhängig von der Sprache zu "Vereinigte Staaten", sodass Sie stattdessen mit dem Kulturenamen arbeiten sollten.

• Wenn Skriptunterschiede berücksichtigt werden müssen. Beispielsweise befasst sich das Land/die Region AZ mit aserbaidschanischen Kulturen mit den Namen az-Latn-AZ und az-Cyrl-AZ, und die lateinischen und kyrillischen Schriften können für dieses Land/diese Region sehr unterschiedlich sein.

• Wenn die Wartung von Details wichtig ist. Die von RegionInfo Membern zurückgegebenen Werte können abhängig davon variieren, ob das RegionInfo Objekt mithilfe eines Kulturnamens oder eines Regionsnamens instanziiert wurde. In der folgenden Tabelle werden beispielsweise die Unterschiede bei Rückgabewerten aufgelistet, wenn ein RegionInfo Objekt mithilfe der Region "US", der "en-US" Kultur und der "es-US" Kultur instanziiert wird.

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

Weitere Informationen

• CultureInfo