Verwenden der CultureInfo-Klasse

Artikel
08/10/2011

Die CultureInfo-Klasse enthält kulturbezogene Informationen (z. B. die Sprache, das Land/die Region, den Kalender und kulturelle Konventionen). Diese Klasse enthält darüber hinaus Informationen, die für die Durchführung kulturabhängiger Operationen erforderlich sind (z. B. für die Groß-/Kleinschreibung, für die Formatierung von Datumsangaben und Zahlen sowie für Vergleiche von Zeichenfolgen).

Die CultureInfo-Klasse gibt einen eindeutigen Namen für jede Kultur an. Eine Liste der Kulturnamen finden Sie in der Beschreibung der CultureInfo-Klasse. Die Anwendung kann mithilfe der GetCultures-Methode eine vollständige Liste aller Kulturen abrufen. Das folgende Beispiel zeigt eine Liste aller Kulturen.

Imports System
Imports System.Globalization

public class printClass
   Public Shared Sub Main()  
      Dim ci As CultureInfo
      For Each ci in _
      CultureInfo.GetCultures(CultureTypes.AllCultures)
         Console.WriteLine(ci)
      Next ci
   End Sub
End Class

using System;
using System.Globalization;

public class printClass
{
   public static void Main()
   {
      foreach (CultureInfo ci in
      CultureInfo.GetCultures(CultureTypes.AllCultures))
      {
         Console.WriteLine(ci);
      }
   }
}

Verwenden von "CultureInfo" bei nicht verwaltetem Code

Hinweis
.NET Framework-Anwendungen können mithilfe des Genauere Betrachtung von Plattformaufrufen-Dienstes auf nicht verwaltete Funktionen in DLLs (Dynamic Link Libraries) zugreifen.

Zum Initialisieren von Länder-/Regionsinformationen kann die Anwendung ein CultureInfo-Objekt an ein RegionInfo-Objekt übergeben, das dem Land bzw. der Region entspricht. Alternativ kann die Anwendung in nicht verwaltetem Code ein CultureInfo-Objekt an die Win32-Funktion GetLocaleInfo übergeben.

Zur Initialisierung eines RegionInfo-Objekts mithilfe eines CultureInfo-Objekts muss die Anwendung ein CultureInfo-Objekt angeben, das eine bestimmte Kultur darstellt, z. B. "ar-DZ" für Arabisch (Algerien). Bei dem Versuch, ein RegionInfo-Objekt mit einem CultureInfo-Objekt zu initialisieren, das eine neutrale Kultur darstellt (z. B. "ar" für Arabisch), wird eine Ausnahme ausgelöst. Die neutrale Kultur gibt die Länder-/Regionsinformationen, die für die Zuordnung zu einem Land bzw. einer Region erforderlich sind, nicht an.

Die GetLocaleInfo-Methode unterscheidet sich vom RegionInfo-Konstruktor darin, dass sie ein Land/eine Region für ein CultureInfo-Objekt zurückgibt, das entweder eine bestimmte oder eine neutrale Kultur darstellt. Wenn die Anwendung z. B. ein CultureInfo-Objekt, das die neutrale Kultur Arabisch darstellt, an GetLocaleInfo übergibt, ordnet die Methode die neutrale Kultur dem Standardland bzw. der Standardregion zu, mit dem bzw. der sie verbunden ist. In diesem Fall wird von GetLocaleInfo Saudi-Arabien abgerufen. Gehen Sie bei Verwendung der GetLocaleInfo-Methode sorgfältig vor, da die von ihr standardmäßig bereitgestellte Länder-/Regionszuordnung für die Anwendung kulturell ungeeignet sein kann. Zur Beseitigung dieser Diskrepanz sorgen Sie dafür, dass die Anwendung bei der Interoperation mit einer API-Funktion nur bestimmte Kulturen verwendet.

Das folgende Beispiel veranschaulicht, wie der RegionInfo-Klassenkonstruktor und die GetLocaleInfo-Methode bei der Übergabe desselben CultureInfo-Objekts verschiedene Werte abrufen können. Wenn das CultureInfo-Objekt die bestimmte Kultur Arabisch (Algerien) darstellt, rufen beide Methoden Algerien als Länder-/Regionsnamen ab. Wenn das CultureInfo-Objekt jedoch die neutrale Kultur Arabisch darstellt, unterscheiden sich die Ergebnisse. Das Abrufen eines Landes/einer Region durch den RegionInfo-Konstruktor schlägt fehl, während GetLocaleInfo Algerien abruft.

Imports System
Imports System.Globalization
Imports System.Runtime.InteropServices
Imports Microsoft.VisualBasic

Namespace CountryRegionName
   Class CountryRegionName
      ' The name of a country or region in English.
      Private LOCALE_SENGCOUNTRY As Integer = &H1002

      ' Use COM interop to call the Win32 API GetLocalInfo.
      Declare Unicode Function GetLocaleInfoW Lib "Kernel32.dll" _
         (Locale As Integer, LCType As Integer,<[In](), _
          MarshalAs(UnmanagedType.LPWStr)> lpLCData As String, _
          cchData As Integer) As Integer
      
      ' A method to retrieve the .NET Framework Country/Region
      ' that maps to the specified CultureInfo.
      Public Function GetNetCountryRegionName(ci As CultureInfo) As String
         ' If the specified CultureInfo represents a specific culture,
         ' the attempt to create a RegionInfo succeeds.
         Try
            Dim ri As New RegionInfo(ci.LCID)
            Return ri.EnglishName
         ' Otherwise, the specified CultureInfo represents a neutral
         'culture, and the attempt to create a RegionInfo fails.
         Catch
            Return String.Empty
         End Try
      End Function
      
      ' A method to retrieve the Win32 API Country/Region
      ' that maps to the specified CultureInfo.
      Public Function GetWinCountryRegionName(ci As CultureInfo) As String
         Dim size As Integer = GetLocaleInfoW(ci.LCID, _
            LOCALE_SENGCOUNTRY, Nothing, 0)
         Dim str As New String(" "c, size)
         Dim err As Integer = GetLocaleInfoW(ci.LCID, _
            LOCALE_SENGCOUNTRY, str, size)
         ' If the string is not empty, GetLocaleInfoW succeeded.
         ' It will succeed regardless of whether ci represents
         ' a neutral or specific culture.
         If err <> 0 Then
            Return str
         Else
            Return String.Empty
         End If
      End Function

      <STAThread()> _
      Public Shared Sub Main(args() As String)
         Dim crn As New CountryRegionName()
         
         ' Create a CultureInfo initialized to the neutral Arabic culture.
         Dim ci1 As New CultureInfo(&H1)
         Console.WriteLine(ControlChars.NewLine + _
            "The .NET Region name: {0}", _
            crn.GetNetCountryRegionName(ci1))
         Console.WriteLine("The Win32 Region name: {0}", _
            crn.GetWinCountryRegionName(ci1))
         
         ' Create a CultureInfo initialized to the specific 
         ' culture Arabic in Algeria.
         Dim ci2 As New CultureInfo(&H1401)
         Console.WriteLine(ControlChars.NewLine + _
            "The .NET Region name: {0}", _
            crn.GetNetCountryRegionName(ci2))
         Console.WriteLine("The Win32 Region name: {0}", _
            crn.GetWinCountryRegionName(ci2))
      End Sub
   End Class
End Namespace

using System;
using System.Globalization;
using System.Runtime.InteropServices;

namespace CountryRegionName
{
  class CountryRegionName
  {
    // The name of a country or region in English
    int LOCALE_SENGCOUNTRY     = 0x1002;

    // Use COM interop to call the Win32 API GetLocalInfo.
    [DllImport("kernel32.dll", CharSet=CharSet.Unicode)]
    public static extern int GetLocaleInfo(
       // The locale identifier.
       int Locale,
       // The information type.
       int LCType,
       // The buffer size.
       [In, MarshalAs(UnmanagedType.LPWStr)] string lpLCData,int cchData
     );

    // A method to retrieve the .NET Framework Country/Region
    // that maps to the specified CultureInfo.
    public String GetNetCountryRegionName(CultureInfo ci)
    {
      // If the specified CultureInfo represents a specific culture,
      // the attempt to create a RegionInfo succeeds.
      try
      {
        RegionInfo ri = new RegionInfo(ci.LCID);
        return ri.EnglishName;
      }
      // Otherwise, the specified CultureInfo represents a neutral
      // culture, and the attempt to create a RegionInfo fails.
      catch
      {
        return String.Empty;
      }
    }

    // A method to retrieve the Win32 API Country/Region
    // that maps to the specified CultureInfo.
    public String GetWinCountryRegionName(CultureInfo ci)
    {
      int size = GetLocaleInfo(ci.LCID, LOCALE_SENGCOUNTRY, null, 0);
      String str = new String(' ', size);
      int err  = GetLocaleInfo(ci.LCID, LOCALE_SENGCOUNTRY, str, size);
      // If the string is not empty, GetLocaleInfo succeeded.
      // It will succeed regardless of whether ci represents
      // a neutral or specific culture.
      if(err != 0)  
        return str;
      else
        return String.Empty;
    }

    [STAThread]
    static void Main(string[] args)
    {
      CountryRegionName crn = new CountryRegionName();

      // Create a CultureInfo initialized to the neutral Arabic culture.
      CultureInfo ci1 = new CultureInfo(0x1);  
      Console.WriteLine("\nThe .NET Region name: {0}", 
         crn.GetNetCountryRegionName(ci1));
      Console.WriteLine("The Win32 Region name: {0}",
         crn.GetWinCountryRegionName(ci1));

      // Create a CultureInfo initialized to the specific 
      // culture Arabic in Algeria.
      CultureInfo ci2 = new CultureInfo(0x1401);  
      Console.WriteLine("\nThe .NET Region name: {0}", 
         crn.GetNetCountryRegionName(ci2));
      Console.WriteLine("The Win32 Region name: 
         {0}",crn.GetWinCountryRegionName(ci2));
    }
   }
}

Mit diesem Beispiel wird die folgende Ausgabe erzeugt:

The .NET Region name:
The Win32 Region name: Saudi Arabia

The .NET Region name: Algeria
The Win32 Region name: Algeria

Siehe auch

Verwenden der CultureInfo-Klasse

Verwenden von "CultureInfo" bei nicht verwaltetem Code

Siehe auch

Referenz

Konzepte

Weitere Ressourcen

Zusätzliche Ressourcen