CultureInfo.CreateSpecificCulture(String) CultureInfo.CreateSpecificCulture(String) CultureInfo.CreateSpecificCulture(String) CultureInfo.CreateSpecificCulture(String) Method

Definition

Erstellt eine CultureInfo, die die zum angegebenen Namen gehörige spezifische Kultur darstellt.Creates a CultureInfo that represents the specific culture that is associated with the specified name.

public:
 static System::Globalization::CultureInfo ^ CreateSpecificCulture(System::String ^ name);
public static System.Globalization.CultureInfo CreateSpecificCulture (string name);
static member CreateSpecificCulture : string -> System.Globalization.CultureInfo
Public Shared Function CreateSpecificCulture (name As String) As CultureInfo

Parameter

name
String String String String

Ein vordefinierter CultureInfo-Name oder der Name eines vorhandenen CultureInfo-Objekts.A predefined CultureInfo name or the name of an existing CultureInfo object. Bei name wird nicht zwischen Groß- und Kleinschreibung unterschieden.name is not case-sensitive.

Gibt zurück

Ein CultureInfo-Objekt, das Folgendes darstellt:A CultureInfo object that represents: Die invariante Kultur, wenn name eine leere Zeichenfolge ist ("").The invariant culture, if name is an empty string ("").

- oder --or- Die spezifische name zugeordnete Kultur, wenn name eine neutrale Kultur ist.The specific culture associated with name, if name is a neutral culture.

- oder --or- Die von name angegebene Kultur, wenn name bereits eine bestimmte Kultur ist.The culture specified by name, if name is already a specific culture.

Ausnahmen

name ist kein gültiger Kulturname.name is not a valid culture name.

- oder --or- Der von name angegebenen Kultur ist keine bestimmte Kultur zugeordnet.The culture specified by name does not have a specific culture associated with it.

Beispiele

Das folgende Beispiel ruft ein Array von CultureInfo neutrale Kulturen aus darstellende – Objekte die GetCultures Methode und das Array sortiert.The following example retrieves an array of CultureInfo objects that represent neutral cultures from the GetCultures method and sorts the array. Wenn sie die Elemente im Array durchläuft, übergibt den Namen der einzelnen neutrale Kultur, die CreateSpecificCulture -Methode und zeigt der Namen der spezifischen Kultur, die von der-Methode zurückgegeben.When it iterates the elements in the array, it passes the name of each neutral culture to the CreateSpecificCulture method and displays the name of the specific culture returned by the method.

Hinweis

Im Beispiel wird die Kulturnamen Zh-CHS und Zh-CHT.The example uses the zh-CHS and zh-CHT culture names. Jedoch Anwendungen, Windows Vista und später Zh-Hans statt Zh-CHS und Zh-Hant statt Zh-CHT verwenden sollten.However, applications that target Windows Vista and later should use zh-Hans instead of zh-CHS and zh-Hant instead of zh-CHT. Zh-Hans und Zh-Hant wird den aktuellen Standard darstellen, und sollte verwendet werden, es sei denn, Sie einen Grund für die Verwendung der älteren Namen haben.zh-Hans and zh-Hant represent the current standard and should be used unless you have a reason for using the older names.

Beachten Sie außerdem, dass die Ergebnisse des Beispiels auf einer Installation von Windows Taiwanesisch, abweichen können, in dem die Eingabe einer Chinesisch (traditionell) neutralen Kultur (Zh, Zh-CHT oder Zh-Hant) Zh-TW zurückgibt.Note also that the results of the example may differ on an installation of Taiwanese Windows, where the input of a Chinese (Traditional) neutral culture (zh, zh-CHT, or zh-Hant) will return zh-TW.

using System;
using System.Collections.Generic;
using System.Globalization;
using System.Reflection;

public class Example
{
   public static void Main()
   {
      // Display the header.
      Console.WriteLine("{0,-53}{1}", "CULTURE", "SPECIFIC CULTURE");

      // Get each neutral culture in the .NET Framework.
      CultureInfo[] cultures = CultureInfo.GetCultures(CultureTypes.NeutralCultures);
      // Sort the returned array by name.
      Array.Sort<CultureInfo>(cultures, new NamePropertyComparer<CultureInfo>());
      
      // Determine the specific culture associated with each neutral culture.
      foreach (var culture in cultures) 
      {
         Console.Write("{0,-12} {1,-40}", culture.Name, culture.EnglishName);
         try {
            Console.WriteLine("{0}", CultureInfo.CreateSpecificCulture(culture.Name).Name);
         }   
         catch (ArgumentException) {
            Console.WriteLine("(no associated specific culture)");
         }
      } 
   }
}

public class NamePropertyComparer<T> : IComparer<T>
{
   public int Compare(T x, T y) 
   {
      if (x == null)
         if (y == null)
            return 0;
         else
            return -1;

      PropertyInfo pX = x.GetType().GetProperty("Name");
      PropertyInfo pY = y.GetType().GetProperty("Name");             
      return String.Compare((string) pX.GetValue(x, null), (string) pY.GetValue(y, null));
   }
}
// The example displays the following output:
//    CULTURE                                              SPECIFIC CULTURE
//                 Invariant Language (Invariant Country)  
//    af           Afrikaans                               af-ZA
//    am           Amharic                                 am-ET
//    ar           Arabic                                  ar-SA
//    arn          Mapudungun                              arn-CL
//    as           Assamese                                as-IN
//    az           Azerbaijani                             az-Latn-AZ
//    az-Cyrl      Azerbaijani (Cyrillic)                  az-Cyrl-AZ
//    az-Latn      Azerbaijani (Latin)                     az-Latn-AZ
//    ba           Bashkir                                 ba-RU
//    be           Belarusian                              be-BY
//    bg           Bulgarian                               bg-BG
//    bn           Bengali                                 bn-IN
//    bo           Tibetan                                 bo-CN
//    br           Breton                                  br-FR
//    bs           Bosnian                                 bs-Latn-BA
//    bs-Cyrl      Bosnian (Cyrillic)                      bs-Cyrl-BA
//    bs-Latn      Bosnian (Latin)                         bs-Latn-BA
//    ca           Catalan                                 ca-ES
//    co           Corsican                                co-FR
//    cs           Czech                                   cs-CZ
//    cy           Welsh                                   cy-GB
//    da           Danish                                  da-DK
//    de           German                                  de-DE
//    dsb          Lower Sorbian                           dsb-DE
//    dv           Divehi                                  dv-MV
//    ...
//    ta           Tamil                                   ta-IN
//    te           Telugu                                  te-IN
//    tg           Tajik                                   tg-Cyrl-TJ
//    tg-Cyrl      Tajik (Cyrillic)                        tg-Cyrl-TJ
//    th           Thai                                    th-TH
//    tk           Turkmen                                 tk-TM
//    tn           Setswana                                tn-ZA
//    tr           Turkish                                 tr-TR
//    tt           Tatar                                   tt-RU
//    tzm          Tamazight                               tzm-Latn-DZ
//    tzm-Latn     Tamazight (Latin)                       tzm-Latn-DZ
//    ug           Uyghur                                  ug-CN
//    uk           Ukrainian                               uk-UA
//    ur           Urdu                                    ur-PK
//    uz           Uzbek                                   uz-Latn-UZ
//    uz-Cyrl      Uzbek (Cyrillic)                        uz-Cyrl-UZ
//    uz-Latn      Uzbek (Latin)                           uz-Latn-UZ
//    vi           Vietnamese                              vi-VN
//    wo           Wolof                                   wo-SN
//    xh           isiXhosa                                xh-ZA
//    yo           Yoruba                                  yo-NG
//    zh           Chinese                                 zh-CN
//    zh-CHS       Chinese (Simplified) Legacy             zh-CN
//    zh-CHT       Chinese (Traditional) Legacy            zh-HK
//    zh-Hans      Chinese (Simplified)                    zh-CN
//    zh-Hant      Chinese (Traditional)                   zh-HK
//    zu           isiZulu                                 zu-ZA
Imports System.Collections.Generic
Imports System.Globalization
Imports System.Reflection

Public Class Example
   Public Shared Sub Main()
      ' Display the header.
      Console.WriteLine("{0,-53}{1}", "CULTURE", "SPECIFIC CULTURE")

      ' Get each neutral culture in the .NET Framework.
      Dim cultures() As CultureInfo = CultureInfo.GetCultures(CultureTypes.NeutralCultures)
      ' Sort the returned array by name.
      Array.Sort(Of CultureInfo)(cultures, New NamePropertyComparer(Of CultureInfo)())
      
      ' Determine the specific culture associated with each neutral culture.
      For Each culture As CultureInfo In cultures
         Console.Write("{0,-12} {1,-40}", culture.Name, culture.EnglishName)
         Try
            Console.WriteLine("{0}", CultureInfo.CreateSpecificCulture(culture.Name).Name)
         Catch e As ArgumentException
            Console.WriteLine("(no associated specific culture)")
         End Try
      Next 
   End Sub
End Class

Public Class NamePropertyComparer(Of T) : Implements IComparer(Of T)
   Public Function Compare(x As T, y As T) As Integer _
                   Implements IComparer(Of T).Compare
      If x Is Nothing Then
         If y Is Nothing Then
            Return 0
         Else
            Return -1
         End If
      End If 
      Dim pX As PropertyInfo = x.GetType().GetProperty("Name")
      Dim pY As PropertyInfo = y.GetType().GetProperty("Name")             
      Return String.Compare(CStr(pX.GetValue(x, Nothing)), CStr(pY.GetValue(y, Nothing)))
   End Function
End Class
' The example displays the following output.  This output has been cropped for brevity.
'    CULTURE                                              SPECIFIC CULTURE
'                 Invariant Language (Invariant Country)  
'    af           Afrikaans                               af-ZA
'    am           Amharic                                 am-ET
'    ar           Arabic                                  ar-SA
'    arn          Mapudungun                              arn-CL
'    as           Assamese                                as-IN
'    az           Azerbaijani                             az-Latn-AZ
'    az-Cyrl      Azerbaijani (Cyrillic)                  az-Cyrl-AZ
'    az-Latn      Azerbaijani (Latin)                     az-Latn-AZ
'    ba           Bashkir                                 ba-RU
'    be           Belarusian                              be-BY
'    bg           Bulgarian                               bg-BG
'    bn           Bengali                                 bn-IN
'    bo           Tibetan                                 bo-CN
'    br           Breton                                  br-FR
'    bs           Bosnian                                 bs-Latn-BA
'    bs-Cyrl      Bosnian (Cyrillic)                      bs-Cyrl-BA
'    bs-Latn      Bosnian (Latin)                         bs-Latn-BA
'    ca           Catalan                                 ca-ES
'    co           Corsican                                co-FR
'    cs           Czech                                   cs-CZ
'    cy           Welsh                                   cy-GB
'    da           Danish                                  da-DK
'    de           German                                  de-DE
'    dsb          Lower Sorbian                           dsb-DE
'    dv           Divehi                                  dv-MV
'    ...
'    ta           Tamil                                   ta-IN
'    te           Telugu                                  te-IN
'    tg           Tajik                                   tg-Cyrl-TJ
'    tg-Cyrl      Tajik (Cyrillic)                        tg-Cyrl-TJ
'    th           Thai                                    th-TH
'    tk           Turkmen                                 tk-TM
'    tn           Setswana                                tn-ZA
'    tr           Turkish                                 tr-TR
'    tt           Tatar                                   tt-RU
'    tzm          Tamazight                               tzm-Latn-DZ
'    tzm-Latn     Tamazight (Latin)                       tzm-Latn-DZ
'    ug           Uyghur                                  ug-CN
'    uk           Ukrainian                               uk-UA
'    ur           Urdu                                    ur-PK
'    uz           Uzbek                                   uz-Latn-UZ
'    uz-Cyrl      Uzbek (Cyrillic)                        uz-Cyrl-UZ
'    uz-Latn      Uzbek (Latin)                           uz-Latn-UZ
'    vi           Vietnamese                              vi-VN
'    wo           Wolof                                   wo-SN
'    xh           isiXhosa                                xh-ZA
'    yo           Yoruba                                  yo-NG
'    zh           Chinese                                 zh-CN
'    zh-CHS       Chinese (Simplified) Legacy             zh-CN
'    zh-CHT       Chinese (Traditional) Legacy            zh-HK
'    zh-Hans      Chinese (Simplified)                    zh-CN
'    zh-Hant      Chinese (Traditional)                   zh-HK
'    zu           isiZulu                                 zu-ZA

Hinweise

Die CreateSpecificCulture Methode bindet einen Aufruf der CultureInfo(String) Konstruktor.The CreateSpecificCulture method wraps a call to the CultureInfo(String) constructor.

Hinweis

Eine Liste von vordefinierten Kulturnamen finden Sie in der National Language Support (NLS) API-Referenz am Go Global Developer Center.For a list of predefined culture names, see the National Language Support (NLS) API Reference at the Go Global Developer Center. Darüber hinaus beginnend mit Windows 10, name möglich, dass alle gültigen BCP-47-Sprachtag.In addition, starting with Windows 10, name can be any valid BCP-47 language tag.

Kulturen werden in drei Gruppen zusammengefasst: der invarianten Kultur, die neutralen Kulturen und die spezifischen Kulturen.Cultures are grouped into three sets: the invariant culture, the neutral cultures, and the specific cultures. Weitere Informationen finden Sie unter der Beschreibung der CultureInfo Klasse.For more information, see the description of the CultureInfo class.

Wenn Sie der Bezeichner der spezifischen Kultur, die von dieser Methode zurückgegebene den Kulturbezeichner für die aktuelle Windows-Kultur entspricht, erstellt diese Methode eine CultureInfo überschreibt-Objekt, das die Windows-Kultur verwendet.If the culture identifier of the specific culture returned by this method matches the culture identifier of the current Windows culture, this method creates a CultureInfo object that uses the Windows culture overrides. Die Außerkraftsetzungen sind Einstellungen für die Eigenschaften des Benutzers die DateTimeFormatInfo zurückgegebenes Objekt der DateTimeFormat Eigenschaft und die NumberFormatInfo zurückgegebenes Objekt der NumberFormat Eigenschaft.The overrides include user settings for the properties of the DateTimeFormatInfo object returned by the DateTimeFormat property and the NumberFormatInfo object returned by the NumberFormat property. Instanziiert eine CultureInfo Objekt, das standardmäßig kultureinstellungen anstatt Benutzer überschreibt, rufen Sie mit der CultureInfo(String, Boolean) Konstruktor mit einem Wert von false für die useUserOverride Argument.To instantiate a CultureInfo object that with default culture settings rather than user overrides, call the CultureInfo(String, Boolean) constructor with a value of false for the useUserOverride argument.

Obwohl die CreateSpecificCulture Methodennamen enthält den Begriff "Spezifisch", beachten Sie, dass die Kultur zwischen verschiedenen Versionen oder aufgrund von Kulturen oder aufgrund von überschreibungen ändern können.Although the CreateSpecificCulture method name includes the term "Specific", remember that culture data can change between versions, or due to custom cultures, or because of user overrides. Verwenden Sie die invariante Kultur oder binär- oder feste Form zum Speichern von Daten an.Use the invariant culture or binary or fixed forms for saving data.

Hinweise für Aufrufer

Die .NET Framework 3,5.NET Framework 3.5 und frühere Versionen lösen eine ArgumentException Wenn name ist kein gültiger Kulturname.The .NET Framework 3,5.NET Framework 3.5 and earlier versions throw an ArgumentException if name is not a valid culture name. Beginnend mit der .NET Framework 4.NET Framework 4, löst diese Methode eine CultureNotFoundException.Starting with the .NET Framework 4.NET Framework 4, this method throws a CultureNotFoundException.

Gilt für:

Siehe auch