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

新しい CultureAndRegionModifiers オブジェクトがニュートラル カルチャであるかどうか、既存のカルチャと国/地域を置換するかどうか、または新しいカルチャであるかどうかを指定する、いずれかの CultureAndRegionInfoBuilder 値。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
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 'Main
End Class 'Sample
'
'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.

flagsパラメーターが使用される、CultureAndRegionModifiers値を指定するかどうか、新しいCultureAndRegionInfoBuilderオブジェクトが新しいカスタム カルチャの場合、または、既存のニュートラル カルチャ、特定のカルチャまたは Windows ロケールが置き換えられます。The 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オブジェクトのカルチャと国/地域の情報を呼び出すことによって、LoadDataFromCultureInfoLoadDataFromRegionInfoメソッド。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[]"という、languageコンポーネントが必要です、 prefixregion、およびsuffixコンポーネントは省略可能です。The 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コンポーネントは、Internet Assigned Numbers Authority (IANA) 識別します。The prefix component is the Internet Assigned Numbers Authority (IANA) identification. 「I-」を指定または"は、"カルチャ名が登録されている、IANA、または「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、"Tags for the Identification of Languages"を参照してください。For more information, see RFC 4646, "Tags for the Identification of Languages."

languageのコンポーネントである、cultureNameパラメーターは、ISO 639-1 から派生する小文字の 2 文字コードを指定し、 region ISO 3166 から派生する大文字の 2 文字コードを指定します。The 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.

AcultureNameされているものと同じ .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. たとえば、ABC-英語-米国、英語-米国-XYZ、日本、JP-ABC、XYZ JP-日本-EN-US、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.

適用対象

こちらもご覧ください