次の方法で共有


CultureInfo コンストラクタ (Int32)

カルチャ識別子によって指定するカルチャに基づいて、CultureInfo クラスの新しいインスタンスを初期化します。

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

構文

'宣言
Public Sub New ( _
    culture As Integer _
)
'使用
Dim culture As Integer

Dim instance As New CultureInfo(culture)
public CultureInfo (
    int culture
)
public:
CultureInfo (
    int culture
)
public CultureInfo (
    int culture
)
public function CultureInfo (
    culture : int
)

パラメータ

  • culture
    定義済みの CultureInfo 識別子、既存の CultureInfo オブジェクトの LCID プロパティ、または Windows 専用カルチャ識別子。

例外

例外の種類 条件

ArgumentOutOfRangeException

culture が 0 未満です。

ArgumentException

culture が有効なカルチャ識別子ではありません。

または

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

解説

定義済みのカルチャ識別子は、CultureInfo クラスのトピックにリストされています。

ほとんどの場合、culture パラメータは、対応する国別言語サポート (NLS: National Language Support) ロケール識別子に割り当てられます。culture パラメータの値は、新しい CultureInfoLCID プロパティの値になります。

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

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

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

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

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

  • CultureInfo("0x0401") (カルチャ名 "ar-SA") では、CalendarGregorianCalendar (ユーザー設定) に設定され、UseUserOverridetrue に設定されます。

  • CultureInfo("0x041E") (カルチャ名 "th-TH") では、CalendarThaiBuddhistCalendar ("th-TH" の既定の暦) に設定され、UseUserOverridetrue に設定されます。

ユーロを使用するカルチャでは、.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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework

サポート対象 : 2.0、1.1、1.0

.NET Compact Framework

サポート対象 : 2.0、1.0

参照

関連項目

CultureInfo クラス
CultureInfo メンバ
System.Globalization 名前空間
LCID
UseUserOverride