System.Globalization.CultureAndRegionInfoBuilder コンストラクター

この記事では、この API のリファレンス ドキュメントへの補足的な解説を提供します。

この記事は、コンストラクターに CultureAndRegionInfoBuilder(String, CultureAndRegionModifiers) 関連します。

このパラメーターは cultureName 、新しい CultureAndRegionInfoBuilder オブジェクトの名前を指定します。

このflagsパラメーターは、新しいオブジェクトが新しいCultureAndRegionInfoBuilderカスタム カルチャであるか、既存のニュートラル カルチャ、特定のカルチャ、または Windows ロケールに置き換えられるかを指定する値に使用CultureAndRegionModifiersされます。

このパラメーターで cultureName 、Windows ロケールから生成された既存の .NET カルチャ、登録済みのカスタム カルチャ、またはカルチャが指定されている場合、 CultureAndRegionInfoBuilder コンストラクターは新しい CultureAndRegionInfoBuilder オブジェクトにカルチャと国/地域の情報を自動的に設定します。

メソッドを呼び出して、新しいCultureAndRegionInfoBuilderオブジェクトにカルチャと国/地域の情報をLoadDataFromCultureInfoLoadDataFromRegionInfo設定します。

カスタム カルチャ名

新しいカスタム カルチャのcultureNameパラメーターの優先形式は "[prefix-]language[-][-regionsuffix[]…]" です。このlanguage形式では、コンポーネントが必須でありprefix、,regionおよびsuffixコンポーネントは省略可能です。 各コンポーネントの最大長は 8 文字で、パラメーター全体 cultureName の最大長は 84 文字です。

コンポーネントは prefix 、インターネット割り当て番号機関 (IANA) ID です。 IANA に登録されているカルチャ名には "i-" または "I-" を、プライベート用に予約されたカルチャ名には "x-" または "X-" を指定します。 それ以外の場合、プレフィックスは必要ありません。 詳細については、RFC 4646「言語の識別のためのタグ」を参照してください。

パラメーターのcultureNameコンポーネントはlanguage、ISO 639-1 から派生した小文字の 2 文字コードを指定しregion、ISO 3166 から派生した大文字の 2 文字コードを指定します。 たとえば、en-US は、米国で話される英語を表します。 コンポーネントが region 存在しないことは、ニュートラル カルチャを意味します。

cultureName.NET に含まれるカルチャの名前と同じ A は、置換 (オーバーライド) カルチャを意味します。 置換カルチャのプロパティに割り当てることができる値は制限されています。 このような制限の詳細については、各プロパティの例外を参照してください。

アプリケーションでは、コンポーネントを suffix 使用して同様のカルチャを区別します。 たとえば、ABC と XYZ の 2 社は、新しい ASP.NET Web サービスを作成して共有し、世界中のさまざまな市場で製品を宣伝しています。 サービスの Web ページには、ユーザーの文化に応じて、各会社の地域のロゴや地域の電話番号などの情報が表示されます。 各 Web ページのカルチャ固有のコンテンツは、カルチャ名で識別され、会社名で修飾された個別のリソース ファイル内にあります。 たとえば、en-US カルチャと ja-JP カルチャのリソース ファイルの名前は、en-US-ABC、en-US-XYZ、ja-JP-ABC、ja-JP-XYZ です。 "ABC" サフィックスと "XYZ" サフィックスを使用すると、Web サービスは同じアプリケーション ロジックを使用して、異なる市場固有の情報を表示できます。

コンポーネントは suffix サブコンポーネントで構成できます。各サブコンポーネントはハイフンで区切られ、各サブコンポーネントの最大長は 8 文字です。 たとえば、"en-US-honda-cars" がパラメーターの cultureName 場合、"-honda-cars" が suffix コンポーネントになります。