CultureInfo.GetCultures(CultureTypes) Methode

Referenz

Definition

Namespace:: System.Globalization

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Quelle:: CultureInfo.cs

Quelle:: CultureInfo.cs

Quelle:: CultureInfo.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft die Liste der unterstützten Kulturen ab, die entsprechend dem angegebenen CultureTypes-Parameter gefiltert sind.

public:
 static cli::array <System::Globalization::CultureInfo ^> ^ GetCultures(System::Globalization::CultureTypes types);

public static System.Globalization.CultureInfo[] GetCultures (System.Globalization.CultureTypes types);

static member GetCultures : System.Globalization.CultureTypes -> System.Globalization.CultureInfo[]

Public Shared Function GetCultures (types As CultureTypes) As CultureInfo()

Parameter

types: CultureTypes

Eine bitweise Kombination von Enumerationswerten, mit denen die abzurufenden Kulturen gefiltert werden.

Gibt zurück

CultureInfo[]

Ein Array, das die vom types-Parameter angegebenen Kulturen enthält. Das Array von Kulturen ist unsortiert.

Ausnahmen

ArgumentOutOfRangeException

types gibt eine ungültige Kombination von CultureTypes-Werten an.

Beispiele

Im folgenden Codebeispiel werden mehrere Eigenschaften der neutralen Kulturen angezeigt.

Hinweis

Im Beispiel werden die zh-CHS Kulturen und zh-CHT mit den 0x0004 bzw. 0x7C04 Kulturbezeichnern angezeigt. Ihre Windows Vista-Anwendungen sollten jedoch anstelle zh-Hans von zh-CHS zh-CHT den Namen und den zh-Hant Namen verwenden. Die zh-Hans Namen und zh-Hant stellen den aktuellen Standard dar und sollten verwendet werden, es sei denn, Sie haben einen Grund für die Verwendung der älteren Namen.

using namespace System;
using namespace System::Globalization;
int main()
{
   
   // Displays several properties of the neutral cultures.
   Console::WriteLine( "CULTURE ISO ISO WIN DISPLAYNAME                              ENGLISHNAME" );
   System::Collections::IEnumerator^ enum0 = CultureInfo::GetCultures( CultureTypes::NeutralCultures )->GetEnumerator();
   while ( enum0->MoveNext() )
   {
      CultureInfo^ ci = safe_cast<CultureInfo^>(enum0->Current);
      Console::Write( "{0,-7}", ci->Name );
      Console::Write( " {0,-3}", ci->TwoLetterISOLanguageName );
      Console::Write( " {0,-3}", ci->ThreeLetterISOLanguageName );
      Console::Write( " {0,-3}", ci->ThreeLetterWindowsLanguageName );
      Console::Write( " {0,-40}", ci->DisplayName );
      Console::WriteLine( " {0,-40}", ci->EnglishName );
   }
}

/*
This code produces the following output.  This output has been cropped for brevity.

CULTURE ISO ISO WIN DISPLAYNAME                              ENGLISHNAME
ar      ar  ara ARA Arabic                                   Arabic                                  
bg      bg  bul BGR Bulgarian                                Bulgarian                               
ca      ca  cat CAT Catalan                                  Catalan                                 
zh-Hans zh  zho CHS Chinese (Simplified)                     Chinese (Simplified)                    
cs      cs  ces CSY Czech                                    Czech                                   
da      da  dan DAN Danish                                   Danish                                  
de      de  deu DEU German                                   German                                  
el      el  ell ELL Greek                                    Greek                                   
en      en  eng ENU English                                  English                                 
es      es  spa ESP Spanish                                  Spanish                                 
fi      fi  fin FIN Finnish                                  Finnish                                 
zh      zh  zho CHS Chinese                                  Chinese                                 
zh-Hant zh  zho CHT Chinese (Traditional)                    Chinese (Traditional)                   
zh-CHS  zh  zho CHS Chinese (Simplified) Legacy              Chinese (Simplified) Legacy             
zh-CHT  zh  zho CHT Chinese (Traditional) Legacy             Chinese (Traditional) Legacy            

*/

using System;
using System.Globalization;

public class SamplesCultureInfo
{

   public static void Main()
   {

      // Displays several properties of the neutral cultures.
      Console.WriteLine("CULTURE ISO ISO WIN DISPLAYNAME                              ENGLISHNAME");
      foreach (CultureInfo ci in CultureInfo.GetCultures(CultureTypes.NeutralCultures))
      {
         Console.Write("{0,-7}", ci.Name);
         Console.Write(" {0,-3}", ci.TwoLetterISOLanguageName);
         Console.Write(" {0,-3}", ci.ThreeLetterISOLanguageName);
         Console.Write(" {0,-3}", ci.ThreeLetterWindowsLanguageName);
         Console.Write(" {0,-40}", ci.DisplayName);
         Console.WriteLine(" {0,-40}", ci.EnglishName);
      }
   }
}


/*
This code produces the following output.  This output has been cropped for brevity.

CULTURE ISO ISO WIN DISPLAYNAME                              ENGLISHNAME
ar      ar  ara ARA Arabic                                   Arabic
bg      bg  bul BGR Bulgarian                                Bulgarian
ca      ca  cat CAT Catalan                                  Catalan
zh-Hans zh  zho CHS Chinese (Simplified)                     Chinese (Simplified)
cs      cs  ces CSY Czech                                    Czech
da      da  dan DAN Danish                                   Danish
de      de  deu DEU German                                   German
el      el  ell ELL Greek                                    Greek
en      en  eng ENU English                                  English
es      es  spa ESP Spanish                                  Spanish
fi      fi  fin FIN Finnish                                  Finnish
zh      zh  zho CHS Chinese                                  Chinese
zh-Hant zh  zho CHT Chinese (Traditional)                    Chinese (Traditional)
zh-CHS  zh  zho CHS Chinese (Simplified) Legacy              Chinese (Simplified) Legacy
zh-CHT  zh  zho CHT Chinese (Traditional) Legacy             Chinese (Traditional) Legacy

*/

Imports System.Globalization

Module Module1

   Public Sub Main()

      ' Displays several properties of the neutral cultures.
      Console.WriteLine("CULTURE ISO ISO WIN DISPLAYNAME                              ENGLISHNAME")
      Dim ci As CultureInfo
      For Each ci In CultureInfo.GetCultures(CultureTypes.NeutralCultures)
         Console.Write("{0,-7}", ci.Name)
         Console.Write(" {0,-3}", ci.TwoLetterISOLanguageName)
         Console.Write(" {0,-3}", ci.ThreeLetterISOLanguageName)
         Console.Write(" {0,-3}", ci.ThreeLetterWindowsLanguageName)
         Console.Write(" {0,-40}", ci.DisplayName)
         Console.WriteLine(" {0,-40}", ci.EnglishName)
      Next ci

   End Sub



'This code produces the following output.  This output has been cropped for brevity.
'
'CULTURE ISO ISO WIN DISPLAYNAME                              ENGLISHNAME
'ar      ar  ara ARA Arabic                                   Arabic                                  
'bg      bg  bul BGR Bulgarian                                Bulgarian                               
'ca      ca  cat CAT Catalan                                  Catalan                                 
'zh-Hans zh  zho CHS Chinese (Simplified)                     Chinese (Simplified)                    
'cs      cs  ces CSY Czech                                    Czech                                   
'da      da  dan DAN Danish                                   Danish                                  
'de      de  deu DEU German                                   German                                  
'el      el  ell ELL Greek                                    Greek                                   
'en      en  eng ENU English                                  English                                 
'es      es  spa ESP Spanish                                  Spanish                                 
'fi      fi  fin FIN Finnish                                  Finnish                                 
'zh      zh  zho CHS Chinese                                  Chinese                                 
'zh-Hant zh  zho CHT Chinese (Traditional)                    Chinese (Traditional)                   
'zh-CHS  zh  zho CHS Chinese (Simplified) Legacy              Chinese (Simplified) Legacy             
'zh-CHT  zh  zho CHT Chinese (Traditional) Legacy             Chinese (Traditional) Legacy            

End Module

Hinweise

Die GetCultures Methode wird am häufigsten aufgerufen, wobei der types Parameter auf die folgenden Werte festgelegt ist:

SpecificCultures, das alle spezifischen Kulturen zurückgibt.
NeutralCultures, die alle neutralen Kulturen und die invariante Kultur zurückgibt.
AllCultures, die alle neutralen und spezifischen Kulturen, Kulturen zurückgibt, die im Windows-System installiert sind, und benutzerdefinierte Kulturen, die vom Benutzer erstellt wurden.

UserCustomCulture, das alle benutzerdefinierten Kulturen zurückgibt, z. B. die von der CultureAndRegionInfoBuilder -Klasse registrierten Kulturen. In Windows-Versionen vor Windows 10 gilt der UserCustomCulture Wert für alle benutzerdefinierten benutzerdefinierten Kulturen. Ab Windows 10 gilt es für Systemkulturen, denen keine vollständigen kulturellen Daten vorliegen und die keinen eindeutigen lokalen Bezeichner aufweisen, wie durch den LCID Eigenschaftswert angegeben. Daher gibt Code wie der folgende code unterschiedliche Ergebnisse zurück, wenn er unter Windows 10 und einer früheren Version von Windows ausgeführt wird.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
       CultureInfo[] cultures = CultureInfo.GetCultures(CultureTypes.UserCustomCulture |
                                                        CultureTypes.SpecificCultures);
      int ctr = 0;
      foreach (var culture in cultures)
         if ((culture.CultureTypes & CultureTypes.UserCustomCulture) == CultureTypes.UserCustomCulture)
            ctr++;

      Console.WriteLine("Number of Specific Custom Cultures: {0}", ctr);
   }
}
// If run under Windows 8, the example displays output like the following:
//      Number of Specific Custom Cultures: 6
// If run under Windows 10, the example displays output like the following:
//      Number of Specific Custom Cultures: 279

Imports System.Globalization

Module Example
   Sub Main()
       Dim cultures() As CultureInfo = CultureInfo.GetCultures(CultureTypes.UserCustomCulture Or
                                                               CultureTypes.SpecificCultures)
      Dim ctr As Integer = 0
      For Each culture In cultures
         If (culture.CultureTypes And CultureTypes.UserCustomCulture) = CultureTypes.UserCustomCulture Then
            ctr += 1
         End If
      Next
      Console.WriteLine("Number of Specific Custom Cultures: {0}", ctr)
   End Sub
End Module
' If run under Windows 8, the example displays output like the following:
'      Number of Specific Custom Cultures: 6
' If run under Windows 10, the example displays output like the following:
'      Number of Specific Custom Cultures: 279

Gilt für:

Weitere Informationen

CultureTypes