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

定義

指定した名前に関連付けられている特定のカルチャを表す CultureInfo を作成します。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

パラメーター

name
String String String String

定義済みの CultureInfo の名前または既存の CultureInfo オブジェクトの名前。A predefined CultureInfo name or the name of an existing CultureInfo object. name では、大文字と小文字は区別されません。name is not case-sensitive.

戻り値

次のものを表す CultureInfo オブジェクト。A CultureInfo object that represents: インバリアント カルチャ (nameが空の文字列 ("") の場合)。The invariant culture, if name is an empty string ("").

または-or- name に関連付けられた特定カルチャ (name がニュートラル カルチャの場合)。The specific culture associated with name, if name is a neutral culture.

または-or- name で指定されたカルチャ (name が既に特定カルチャの場合)。The culture specified by name, if name is already a specific culture.

例外

name が有効なカルチャ名ではありません。name is not a valid culture name.

または-or- name で指定するカルチャに関連付けられている特定のカルチャがありません。The culture specified by name does not have a specific culture associated with it.

次の例の配列を取得するCultureInfoからのニュートラル カルチャを表すオブジェクト、GetCulturesメソッド、配列を並べ替えます。The following example retrieves an array of CultureInfo objects that represent neutral cultures from the GetCultures method and sorts the array. 各ニュートラル カルチャの名前、配列内の要素を反復処理の際に渡して、CreateSpecificCultureメソッドとメソッドによって返される特定のカルチャの名前が表示されます。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.

注意

ZH-CHS および ZH-CHT のカルチャ名を使用します。The example uses the zh-CHS and zh-CHT culture names. ただし、Windows Vista を対象し、ZH-CHS および ZH-CHT のではなく Zh-hant ではなく Zh-hans を後では使用するアプリケーション。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 および Zh-hant は、現在の標準を表し、古い名前を使用する理由がないために使用する必要があります。zh-Hans and zh-Hant represent the current standard and should be used unless you have a reason for using the older names.

また、例の結果は、中国語繁体字中国ニュートラル カルチャ (zh、ZH-CHT、または Zh-hant) の入力が ZH-TW を返す、台湾語の Windows のインストールで異なる場合があります。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

注釈

CreateSpecificCultureメソッドへの呼び出しをラップする、CultureInfo(String)コンス トラクター。The CreateSpecificCulture method wraps a call to the CultureInfo(String) constructor.

注意

定義済みカルチャ名の一覧は、次を参照してください。、各国語サポート (NLS) API リファレンス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. さらに、Windows 10 以降で、name任意の有効な bcp-47 言語タグを指定できます。In addition, starting with Windows 10, name can be any valid BCP-47 language tag.

カルチャは、3 つのセットにグループ化されます。 インバリアント カルチャ、ニュートラル カルチャ、および特定のカルチャ。Cultures are grouped into three sets: the invariant culture, the neutral cultures, and the specific cultures. 詳細については、の説明を参照して、CultureInfoクラス。For more information, see the description of the CultureInfo class.

このメソッドによって返される特定のカルチャのカルチャ識別子には、Windows の現在のカルチャのカルチャ識別子が一致すると、このメソッドは、作成、 CultureInfo Windows カルチャを使用するオブジェクトよりも優先されます。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. 上書きのプロパティのユーザー設定を含める、DateTimeFormatInfoによって返されるオブジェクト、DateTimeFormatプロパティおよびNumberFormatInfoによって返されるオブジェクト、NumberFormatプロパティ。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. インスタンス化する、CultureInfoオブジェクトの既定値のカルチャ設定、ユーザーの上書きではなく呼び出すこと、CultureInfo(String, Boolean)の値を持つコンス トラクターfalseuseUserOverride引数。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.

ただし、CreateSpecificCultureメソッド名には、「特定」という用語が含まれています。、、のバージョンとの間またはカスタム カルチャ、またはユーザー オーバーライドのため、カルチャのデータを変更できることに注意してください。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. データを保存するためには、インバリアント カルチャまたはバイナリであるか、または固定のフォームを使用します。Use the invariant culture or binary or fixed forms for saving data.

注意 (呼び出し元)

.NET Framework 3.5.NET Framework 3.5以前のバージョンをスローして、ArgumentException場合name有効なカルチャ名ではありません。The .NET Framework 3.5.NET Framework 3.5 and earlier versions throw an ArgumentException if name is not a valid culture name. 以降では、 .NET Framework 4.NET Framework 4、このメソッドは、CultureNotFoundExceptionします。Starting with the .NET Framework 4.NET Framework 4, this method throws a CultureNotFoundException.

適用対象

こちらもご覧ください