CultureInfo コンストラクタ (String)

[アーティクル]
08/14/2007

名前で指定するカルチャに基づいて、CultureInfo クラスの新しいインスタンスを初期化します。

名前空間: System.Globalization
アセンブリ: mscorlib (mscorlib.dll 内)

構文

'宣言
Public Sub New ( _
    name As String _
)
'使用
Dim name As String

Dim instance As New CultureInfo(name)

public CultureInfo (
    string name
)

public:
CultureInfo (
    String^ name
)

public CultureInfo (
    String name
)

public function CultureInfo (
    name : String
)

パラメータ

name
定義済みの CultureInfo 名、既存の CultureInfo の Name、または Windows 専用カルチャ名。

例外

例外の種類	条件
ArgumentNullException	name が null 参照 (Visual Basic では Nothing) です。
ArgumentException	name が有効なカルチャ名ではありません。または .NET Compact Framework アプリケーションでは、デバイスのオペレーティングシステムで culture はサポートされていません。

ArgumentNullException

name が null 参照 (Visual Basic では Nothing) です。

ArgumentException

name が有効なカルチャ名ではありません。

または

.NET Compact Framework アプリケーションでは、デバイスのオペレーティングシステムで culture はサポートされていません。

解説

CultureInfo の名前は、RFC 1766 標準の "<languagecode2>-<country/regioncode2>" という形式に準拠します。<languagecode2> は ISO 639-1 の 2 桁の小文字コードであり、<country/regioncode2> は ISO 3166 の 2 桁の大文字コードです。たとえば、米国の英語は "en-US" となります。2 文字の言語コードが存在しない場合は、ISO 639-2 から派生した 3 文字のコードを使用します。たとえば、3 文字のコード "div" は、ディベヒ語を使用するカルチャに対して使用します。定義済みの CultureInfo の名前は、CultureInfo クラスのトピックに一覧表示されています。

新しい CultureInfo の LCID プロパティは、指定した名前に関連付けられたカルチャ識別子に設定されます。

ユーザーは、[コントロールパネル] の [地域と言語のオプション] (オペレーティングシステムによっては [地域のオプション] または [地域]) を使用して、Windows の現在のカルチャに関連付けられた値の一部をオーバーライドすることもできます。たとえば、ユーザーが別の形式で日付を表示したり、カルチャの既定の通貨以外の通貨を使用したりすることを選択する場合があります。

指定したカルチャ名に関連付けられているカルチャ識別子が Windows の現在のカルチャのカルチャ識別子と一致する場合、このコンストラクタは、これらのオーバーライド値を使用する CultureInfo を作成します。オーバーライド値には、DateTimeFormat プロパティによって返される DateTimeFormatInfo インスタンスのプロパティ、および NumberFormat プロパティによって返される NumberFormatInfo インスタンスのプロパティのユーザー設定値が含まれます。ユーザー設定と CultureInfo に関連付けられたカルチャとの間に互換性がない場合 (たとえば、選択されたカレンダーが OptionalCalendars のいずれかでない場合)、メソッドの結果およびプロパティの値は未定義です。

指定したカルチャ名に関連付けられているカルチャ識別子が Windows の現在のカルチャのカルチャ識別子と一致しない場合、このコンストラクタは、指定したカルチャの既定値を使用する CultureInfo を作成します。

UseUserOverride プロパティは、必ず true に設定されます。

たとえば、"アラビア語 - サウジアラビア" (カルチャ名 "ar-SA"、カルチャ識別子 "0x0401") が Windows の現在のカルチャで、ユーザーが暦の設定を回教暦からグレゴリオ暦に変更したと想定します。

CultureInfo("ar-SA") (カルチャ識別子 "0x0401") では、Calendar が GregorianCalendar (ユーザー設定) に設定され、UseUserOverride が true に設定されます。
CultureInfo("th-TH") (カルチャ識別子 "0x041E") では、Calendar が ThaiBuddhistCalendar ("th-TH" の既定の暦) に設定され、UseUserOverride が true に設定されます。

ユーロを使用するカルチャでは、.NET Framework および Windows XP では既定の通貨がユーロに設定されますが、以前のバージョンの Windows ではこの設定は行われません。したがって、以前のバージョンの Windows で [コントロールパネル] の [地域のオプション] または [地域] を使用して通貨の設定を変更していない場合は、通貨が正しく表示されない場合があります。通貨に対する .NET Framework の既定値を使用するには、useUserOverride パラメータを受け入れる CultureInfo コンストラクタオーバーロードを使用して、そのパラメータを false に設定します。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

次の方法で共有

CultureInfo コンストラクタ (String)

構文

パラメータ

例外

解説

プラットフォーム

バージョン情報

.NET Framework

.NET Compact Framework

参照

関連項目

その他のリソース