CultureAndRegionInfoBuilder(String, CultureAndRegionModifiers) CultureAndRegionInfoBuilder(String, CultureAndRegionModifiers) CultureAndRegionInfoBuilder(String, CultureAndRegionModifiers) CultureAndRegionInfoBuilder(String, CultureAndRegionModifiers) Constructor

定義

CultureAndRegionInfoBuilder クラスの新しいインスタンスを初期化します。Initializes a new instance of the CultureAndRegionInfoBuilder class.

public:
 CultureAndRegionInfoBuilder(System::String ^ cultureName, System::Globalization::CultureAndRegionModifiers flags);
public CultureAndRegionInfoBuilder (string cultureName, System.Globalization.CultureAndRegionModifiers flags);
new System.Globalization.CultureAndRegionInfoBuilder : string * System.Globalization.CultureAndRegionModifiers -> System.Globalization.CultureAndRegionInfoBuilder
Public Sub New (cultureName As String, flags As CultureAndRegionModifiers)

パラメーター

cultureName
String String String String

カルチャの名前。The name of a culture.

flags
CultureAndRegionModifiers CultureAndRegionModifiers CultureAndRegionModifiers CultureAndRegionModifiers

新しい CultureAndRegionInfoBuilder オブジェクトがニュートラル カルチャであるかどうか、既存のカルチャと国/地域を置換するかどうか、または新しいカルチャであるかどうかを指定する、CultureAndRegionModifiers 値のいずれか 1 つ。One of the CultureAndRegionModifiers values that specifies whether the new CultureAndRegionInfoBuilder object is a neutral culture, replaces an existing culture and country/region, or is a new culture.

例外

cultureName が空の文字列 ("") です。cultureName is the empty string ("").

- または --or- cultureName には、"0" ~ "9"、"a" ~ "z"、"A" ~ "Z"、ハイフン (-)、またはアンダースコア () 以外の文字が含まれています。cultureName contains characters other than "0" through "9", "a" through "z", "A" through "Z", hyphen (-), or underscore ().

- または --or- cultureName に構成要素を区切るためのハイフン (-) が含まれていますが、1 つまたは複数の prefixlanguage, region、または suffix 構成要素が在しません。cultureName contains hyphens (-) to delimit components, but one or more of the prefix, language, region, or suffix components is absent. 言い換えると、2 つ以上のハイフンが隣接しています。That is, two or more hyphens are adjacent.

- または --or- cultureName が 84 文字を超えています。cultureName is longer than 84 characters.

- または --or- cultureName に構成要素を区切るためのハイフン (-) が含まれていますが、1 つまたは複数の構成要素名が 8 文字を超えています。cultureName contains hyphens to delimit components, but one or more of the components is longer than 8 characters.

- または --or- cultureName の先頭または末尾にハイフン (-) またはアンダースコア () が含まれています。cultureName contains a leading or trailing hyphen (-) or underscore ().

- または --or- cultureName は、.NET Framework カルチャの代わりに代替並べ替え置換カルチャを指定します。cultureName specifies an alternate sort replacement culture instead of a .NET Framework culture. たとえば、culturenName は、ドイツ語 (ドイツ) カルチャの "de-DE" ではなく、"de-de_phoneb" です。これは、ドイツの電話帳のように文字列を並べ替えるカルチャです。For example, culturenName is "de-de_phoneb", a culture that sorts strings as they appear in a German telephone book, instead of "de-DE", the German (Germany) culture.

または-or- flagsCultureAndRegionModifiers 値の正しくない組み合わせが含まれています。flags contains an invalid combination of CultureAndRegionModifiers values.

- または --or- flagsReplacement または Neutral が含まれていて、cultureName に指定されているカルチャが見つかりません。flags contains Replacement or Neutral and cultureName specifies a culture that is not found.

- または --or- flagsReplacement が含まれていて、cultureName に、.NET Framework に付属するカルチャを置き換えないユーザー作成のカスタム カルチャが指定されています。flags contains Replacement and cultureName specifies a user-created custom culture that does not replace a culture shipped with the .NET Framework.

- または --or- flagsNeutral が含まれていて、cultureName に、ニュートラル カルチャではないカルチャが指定されています。flags contains Neutral and cultureName specifies a culture that is not a neutral culture.

- または --or- flagsNeutral が含まれていて、cultureName に、.NET Framework に付属する特定のカルチャを置き換えるユーザー作成のカスタム カルチャが指定されています。flags contains Neutral and cultureName specifies a user-created custom culture that replaces a specific culture shipped with the .NET Framework.

次のコード例では、プライベート使用プレフィックスを持つカスタムカルチャを作成し、そのプロパティのセットを一覧表示します。The following code example creates a custom culture with a private use prefix, then lists a set of its properties. 最初のプロパティには、カルチャの名前が表示されます。The first property lists the name of the culture.

// This example demonstrates a System.Globalization.Culture-
// AndRegionInfoBuilder constructor and some of the properties 
// of a custom culture object created with the constructor.

#using <sysglobl.dll>

using namespace System;
using namespace System::Globalization;

int main()
{
    CultureAndRegionInfoBuilder^ builder = 
        gcnew CultureAndRegionInfoBuilder
        ("x-en-US-sample", CultureAndRegionModifiers::None);
    
    // Display some of the properties 
    // for the en-US culture.
    Console::WriteLine("CultureName:. . . . . . . . . . {0}", 
        builder->CultureName);
    Console::WriteLine("CultureEnglishName: . . . . . . {0}", 
        builder->CultureEnglishName);
    Console::WriteLine("CultureNativeName:. . . . . . . {0}", 
        builder->CultureNativeName);
    Console::WriteLine("GeoId:. . . . . . . . . . . . . {0}", 
        builder->GeoId);
    Console::WriteLine("IsMetric: . . . . . . . . . . . {0}", 
        builder->IsMetric);
    Console::WriteLine("ISOCurrencySymbol:. . . . . . . {0}", 
        builder->ISOCurrencySymbol);
    Console::WriteLine("RegionEnglishName:. . . . . . . {0}", 
        builder->RegionEnglishName);
    Console::WriteLine("RegionName: . . . . . . . . . . {0}", 
        builder->RegionName);
    Console::WriteLine("RegionNativeName: . . . . . . . {0}", 
        builder->RegionNativeName);
    Console::WriteLine("ThreeLetterISOLanguageName: . . {0}", 
        builder->ThreeLetterISOLanguageName);
    Console::WriteLine("ThreeLetterISORegionName: . . . {0}", 
        builder->ThreeLetterISORegionName);
    Console::WriteLine("ThreeLetterWindowsLanguageName: {0}", 
        builder->ThreeLetterWindowsLanguageName);
    Console::WriteLine("ThreeLetterWindowsRegionName: . {0}", 
        builder->ThreeLetterWindowsRegionName);
    Console::WriteLine("TwoLetterISOLanguageName: . . . {0}", 
        builder->TwoLetterISOLanguageName);
    Console::WriteLine("TwoLetterISORegionName: . . . . {0}", 
        builder->TwoLetterISORegionName);
}

/*
This code example produces the following results:

CultureName:. . . . . . . . . . en-US
CultureEnglishName: . . . . . . English (United States)
CultureNativeName:. . . . . . . English (United States)
GeoId:. . . . . . . . . . . . . 244
IsMetric: . . . . . . . . . . . False
ISOCurrencySymbol:. . . . . . . USD
RegionEnglishName:. . . . . . . United States
RegionName: . . . . . . . . . . US
RegionNativeName: . . . . . . . United States
ThreeLetterISOLanguageName: . . eng
ThreeLetterISORegionName: . . . USA
ThreeLetterWindowsLanguageName: ENU
ThreeLetterWindowsRegionName: . USA
TwoLetterISOLanguageName: . . . en
TwoLetterISORegionName: . . . . US

*/
// This example demonstrates a System.Globalization.Culture-
// AndRegionInfoBuilder constructor and some of the properties 
// of the CultureAndRegionInfoBuilder object that is created.
// Compile this example with a reference to sysglobl.dll.

using System;
using System.Globalization;

class Sample 
{
    public static void Main() 
    {

// Construct a new, privately used culture that extends the en-US culture 
// provided by the .NET Framework. In this sample, the CultureAndRegion-
// Types.Specific parameter creates a minimal CultureAndRegionInfoBuilder 
// object that you must populate with culture and region information.

    CultureAndRegionInfoBuilder cib = null;
    try {
        cib = new CultureAndRegionInfoBuilder(
                                          "x-en-US-sample",
                                          CultureAndRegionModifiers.None);
        }
    catch (ArgumentException ae)
        {
        Console.WriteLine(ae);
        return;
        }

// Populate the new CultureAndRegionInfoBuilder object with culture information.

    CultureInfo ci = new CultureInfo("en-US");
    cib.LoadDataFromCultureInfo(ci);

// Populate the new CultureAndRegionInfoBuilder object with region information.

    RegionInfo  ri = new RegionInfo("US");
    cib.LoadDataFromRegionInfo(ri);

// Display some of the properties for the x-en-US-sample custom culture.

    Console.Clear();
    Console.WriteLine("CultureName:. . . . . . . . . . {0}", cib.CultureName);
    Console.WriteLine("CultureEnglishName: . . . . . . {0}", cib.CultureEnglishName);
    Console.WriteLine("CultureNativeName:. . . . . . . {0}", cib.CultureNativeName);
    Console.WriteLine("GeoId:. . . . . . . . . . . . . {0}", cib.GeoId);
    Console.WriteLine("IsMetric: . . . . . . . . . . . {0}", cib.IsMetric);
    Console.WriteLine("ISOCurrencySymbol:. . . . . . . {0}", cib.ISOCurrencySymbol);
    Console.WriteLine("RegionEnglishName:. . . . . . . {0}", cib.RegionEnglishName);
    Console.WriteLine("RegionName: . . . . . . . . . . {0}", cib.RegionName);
    Console.WriteLine("RegionNativeName: . . . . . . . {0}", cib.RegionNativeName);
    Console.WriteLine("ThreeLetterISOLanguageName: . . {0}", cib.ThreeLetterISOLanguageName);
    Console.WriteLine("ThreeLetterISORegionName: . . . {0}", cib.ThreeLetterISORegionName);
    Console.WriteLine("ThreeLetterWindowsLanguageName: {0}", cib.ThreeLetterWindowsLanguageName);
    Console.WriteLine("ThreeLetterWindowsRegionName: . {0}", cib.ThreeLetterWindowsRegionName);
    Console.WriteLine("TwoLetterISOLanguageName: . . . {0}", cib.TwoLetterISOLanguageName);
    Console.WriteLine("TwoLetterISORegionName: . . . . {0}", cib.TwoLetterISORegionName);
    }
}
/*
This code example produces the following results:

CultureName:. . . . . . . . . . x-en-US-sample
CultureEnglishName: . . . . . . English
CultureNativeName:. . . . . . . English
GeoId:. . . . . . . . . . . . . 244
IsMetric: . . . . . . . . . . . False
ISOCurrencySymbol:. . . . . . . USD
RegionEnglishName:. . . . . . . United States
RegionName: . . . . . . . . . . US
RegionNativeName: . . . . . . . United States
ThreeLetterISOLanguageName: . . eng
ThreeLetterISORegionName: . . . USA
ThreeLetterWindowsLanguageName: ENU
ThreeLetterWindowsRegionName: . USA
TwoLetterISOLanguageName: . . . en
TwoLetterISORegionName: . . . . US

*/
' This example demonstrates a System.Globalization.Culture-
' AndRegionInfoBuilder constructor and some of the properties 
' of the CultureAndRegionInfoBuilder object that is created.
' Compile this example with a reference to sysglobl.dll.

Imports System.Globalization

Class Sample
    Public Shared Sub Main() 
        
        ' Construct a new, privately used culture that extends the en-US culture 
        ' provided by the .NET Framework. In this sample, the CultureAndRegion-
        ' Types.Specific parameter creates a minimal CultureAndRegionInfoBuilder 
        ' object that you must populate with culture and region information.

        Dim cib As CultureAndRegionInfoBuilder = Nothing
        Try
            cib = New CultureAndRegionInfoBuilder("x-en-US-sample", _
                                                   CultureAndRegionModifiers.None)
        Catch ae As ArgumentException
            Console.WriteLine(ae)
            Return
        End Try
        
        ' Populate the new CultureAndRegionInfoBuilder object with culture information.

        Dim ci As New CultureInfo("en-US")
        cib.LoadDataFromCultureInfo(ci)
        
        ' Populate the new CultureAndRegionInfoBuilder object with region information.

        Dim ri As New RegionInfo("US")
        cib.LoadDataFromRegionInfo(ri)
        
        ' Display some of the properties for the x-en-US-sample custom culture.

        Console.Clear()
        Console.WriteLine("CultureName:. . . . . . . . . . {0}", cib.CultureName)
        Console.WriteLine("CultureEnglishName: . . . . . . {0}", cib.CultureEnglishName)
        Console.WriteLine("CultureNativeName:. . . . . . . {0}", cib.CultureNativeName)
        Console.WriteLine("GeoId:. . . . . . . . . . . . . {0}", cib.GeoId)
        Console.WriteLine("IsMetric: . . . . . . . . . . . {0}", cib.IsMetric)
        Console.WriteLine("ISOCurrencySymbol:. . . . . . . {0}", cib.ISOCurrencySymbol)
        Console.WriteLine("RegionEnglishName:. . . . . . . {0}", cib.RegionEnglishName)
        Console.WriteLine("RegionName: . . . . . . . . . . {0}", cib.RegionName)
        Console.WriteLine("RegionNativeName: . . . . . . . {0}", cib.RegionNativeName)
        Console.WriteLine("ThreeLetterISOLanguageName: . . {0}", cib.ThreeLetterISOLanguageName)
        Console.WriteLine("ThreeLetterISORegionName: . . . {0}", cib.ThreeLetterISORegionName)
        Console.WriteLine("ThreeLetterWindowsLanguageName: {0}", cib.ThreeLetterWindowsLanguageName)
        Console.WriteLine("ThreeLetterWindowsRegionName: . {0}", cib.ThreeLetterWindowsRegionName)
        Console.WriteLine("TwoLetterISOLanguageName: . . . {0}", cib.TwoLetterISOLanguageName)
        Console.WriteLine("TwoLetterISORegionName: . . . . {0}", cib.TwoLetterISORegionName)
    
    End Sub
End Class
'
'This code example produces the following results:
'
'CultureName:. . . . . . . . . . x-en-US-sample
'CultureEnglishName: . . . . . . English
'CultureNativeName:. . . . . . . English
'GeoId:. . . . . . . . . . . . . 244
'IsMetric: . . . . . . . . . . . False
'ISOCurrencySymbol:. . . . . . . USD
'RegionEnglishName:. . . . . . . United States
'RegionName: . . . . . . . . . . US
'RegionNativeName: . . . . . . . United States
'ThreeLetterISOLanguageName: . . eng
'ThreeLetterISORegionName: . . . USA
'ThreeLetterWindowsLanguageName: ENU
'ThreeLetterWindowsRegionName: . USA
'TwoLetterISOLanguageName: . . . en
'TwoLetterISORegionName: . . . . US
'

注釈

パラメーター cultureNameは、新しいCultureAndRegionInfoBuilderオブジェクトの名前を指定します。The cultureName parameter specifies the name of the new CultureAndRegionInfoBuilder object.

パラメーターは、新しいCultureAndRegionModifiers CultureAndRegionInfoBuilderオブジェクトが新しいカスタムカルチャであるか、または既存のニュートラルカルチャ、特定のカルチャ、または Windows ロケールを置き換えるかを指定する値に使用されます。 flagsThe flags parameter is used for a CultureAndRegionModifiers value that specifies whether the new CultureAndRegionInfoBuilder object is a new custom culture, or replaces an existing neutral culture, specific culture, or Windows locale.

パラメーターがcultureName既存の .NET Framework カルチャ、登録されたカスタムカルチャ、または Windows ロケールから生成されCultureAndRegionInfoBuilderたカルチャを指定するCultureAndRegionInfoBuilder場合、コンストラクターは新しいオブジェクトを自動的にカルチャに設定し、国/地域情報。If the cultureName parameter specifies an existing .NET Framework culture, registered custom culture, or culture generated from a Windows locale, the CultureAndRegionInfoBuilder constructor automatically populates the new CultureAndRegionInfoBuilder object with culture and country/region information.

メソッドCultureAndRegionInfoBuilder LoadDataFromCultureInfoとメソッドLoadDataFromRegionInfoを呼び出して、新しいオブジェクトにカルチャおよび国/地域情報を設定します。Populate the new CultureAndRegionInfoBuilder object with culture and country/region information by invoking the LoadDataFromCultureInfo and LoadDataFromRegionInfo methods.

カスタムカルチャ名Custom Culture Names

新しいカスタムカルチャcultureNameのパラメーターには、"[prefix-]language[-region] [-suffix[]]" とprefixいう形式を使用することをlanguageお勧めします。ここで、コンポーネントが必要です。、、 suffixおよびの各コンポーネントは省略可能です。 regionThe preferred format of the cultureName parameter for a new, custom culture is "[prefix-]language[-region][-suffix[]]", where the language component is required and the prefix, region, and suffix components are optional. 各コンポーネントの最大長は8文字で、パラメーター全体cultureNameの最大長は84文字です。The maximum length of each component is 8 characters and the maximum length of the entire cultureName parameter is 84 characters.

prefixコンポーネントは、インターネット割り当て番号機関 (IANA) の id です。The prefix component is the Internet Assigned Numbers Authority (IANA) identification. IANA に登録されているカルチャ名には "i-" または "I-" を指定し、プライベート使用のために予約されているカルチャ名には "x-" または "X-" を指定します。Specify "i-" or "I-" for culture names registered with the IANA, or "x-" or "X-" for culture names reserved for private use. それ以外の場合、プレフィックスは必要ありません。Otherwise, the prefix is not required. 詳細については、RFC 4646 の「言語の Id のタグ」を参照してください。For more information, see RFC 4646, "Tags for the Identification of Languages."

パラメーターのコンポーネントはlanguage 、iso 639-1 から派生した小文字の2文字のコードregionを指定し、iso 3166 から派生した大文字の2文字のコードを指定します。 cultureNameThe language component of the cultureName parameter specifies a lowercase two-letter code derived from ISO 639-1, and region specifies an uppercase two-letter code derived from ISO 3166. たとえば、en-us は、米国で話されている英語を意味します。For example, en-US stands for English as spoken in the United States. regionコンポーネントが存在しない場合は、ニュートラルカルチャを意味します。The absence of the region component signifies a neutral culture.

cultureName .NET Framework に含まれるカルチャの名前と同じであり、置換 (オーバーライド) カルチャを意味します。A cultureName that is the same as the name of a culture included with the .NET Framework signifies a replacement (override) culture. 置換カルチャのプロパティに割り当てることができる値は限られています。The values that can be assigned to the properties of a replacement culture are limited. このような制限事項の詳細については、各プロパティの例外を参照してください。For more information about such limitations, see the exceptions for each property.

アプリケーションでは、 suffixコンポーネントを使用して、類似のカルチャを識別します。The application uses the suffix component to distinguish similar cultures. たとえば、ABC と XYZ という2つの企業は、新しい ASP.NET Web サービスを作成して共有し、世界中のさまざまな市場で製品を宣伝します。For example, two companies, ABC and XYZ, create and share a new ASP.NET Web service to promote their products in different markets around the world. サービスの Web ページには、ユーザーのカルチャに応じて、各会社の地域のロゴや現地の電話番号などの情報が表示されます。The Web pages for the service display information such as the regional logo and local telephone number of each company depending on the user's culture. 各 Web ページのカルチャ固有の内容は、カルチャ名で識別され、会社名によって修飾された個別のリソースファイルにあります。The culture-specific content for each Web page is in separate resource files identified by culture name and qualified by company name. たとえば、en-us カルチャおよび ja-jp カルチャのリソースファイルの名前は、en-us-ABC、en-us-XYZ、ja-jp、ja-jp、および ja-jp という名前になっています。For example, resource files for the en-US and ja-JP cultures are named en-US-ABC, en-US-XYZ, ja-JP-ABC, and ja-JP-XYZ. "ABC" と "XYZ" のサフィックスを使用すると、Web サービスは同じアプリケーションロジックを使用して、さまざまな市場固有の情報を表示できます。The "ABC" and "XYZ" suffixes enable the Web service to use the same application logic to display different market-specific information.

suffixコンポーネントはサブコンポーネントで構成でき、各サブコンポーネントはハイフンで区切られ、各サブコンポーネントの最大長は8文字です。The suffix component can consist of subcomponents, where each subcomponent is delimited by a hyphen and the maximum length of each subcomponent is 8 characters. たとえば、"honda-車" がcultureNameパラメーターである場合、"-honda" がコンポーネントにsuffixなります。For example, if "en-US-honda-cars" is the cultureName parameter, "-honda-cars" is the suffix component.

適用対象

こちらもご覧ください