次の方法で共有


CultureInfo コンストラクタ (Int32, Boolean)

カルチャ識別子で指定したカルチャと、システムからユーザーが選択したカルチャを使用するかどうかを指定するブール値に基づいて、CultureInfo クラスの新しいインスタンスを初期化します。

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

構文

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

Dim instance As New CultureInfo(culture, useUserOverride)
public CultureInfo (
    int culture,
    bool useUserOverride
)
public:
CultureInfo (
    int culture, 
    bool useUserOverride
)
public CultureInfo (
    int culture, 
    boolean useUserOverride
)
public function CultureInfo (
    culture : int, 
    useUserOverride : boolean
)

パラメータ

  • culture
    定義済みの CultureInfo 識別子、既存の CultureInfo オブジェクトの LCID プロパティ、または Windows 専用カルチャ識別子。
  • useUserOverride
    ユーザーが選択したカルチャ設定 (true) または既定のカルチャ設定 (false) のいずれを使用するかを示すブール値。

例外

例外の種類 条件

ArgumentOutOfRangeException

culture が 0 未満です。

ArgumentException

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

または

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

解説

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

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

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

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

それ以外の場合、このコンストラクタは、指定したカルチャの既定値を使用する CultureInfo を作成します。

useUserOverride パラメータの値は、UseUserOverride プロパティの値になります。

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

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

  • CultureInfo("0x0401", false) (カルチャ名 "ar-SA") では、CalendarHijriCalendar ("ar-SA" の既定の暦) に設定され、UseUserOverridefalse に設定されます。

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

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

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