CultureInfo.GetCultureInfo メソッド

定義

カルチャのキャッシュされた読み取り専用インスタンスを取得します。

オーバーロード

GetCultureInfo(String, Boolean)

カルチャのキャッシュされた読み取り専用インスタンスを取得します。

GetCultureInfo(String, String)

カルチャのキャッシュされた読み取り専用インスタンスを取得します。 パラメーターは、別のカルチャで指定された TextInfo オブジェクトおよび CompareInfo オブジェクトで初期化されたカルチャを指定します。

GetCultureInfo(Int32)

指定されたカルチャ識別子を使用して、カルチャのキャッシュされた読み取り専用インスタンスを取得します。

GetCultureInfo(String)

指定されたカルチャ名を使用して、カルチャのキャッシュされた読み取り専用インスタンスを取得します。

GetCultureInfo(String, Boolean)

カルチャのキャッシュされた読み取り専用インスタンスを取得します。

public:
 static System::Globalization::CultureInfo ^ GetCultureInfo(System::String ^ name, bool predefinedOnly);
public static System.Globalization.CultureInfo GetCultureInfo (string name, bool predefinedOnly);
static member GetCultureInfo : string * bool -> System.Globalization.CultureInfo
Public Shared Function GetCultureInfo (name As String, predefinedOnly As Boolean) As CultureInfo

パラメーター

name
String

カルチャの名前。 大文字と小文字は区別されません。

predefinedOnly
Boolean

プラットフォームによって認識されるカルチャのインスタンスの作成を要求する場合は true。 作成されたカルチャを、プラットフォームにそのデータが格納されていなくても取得してよい場合は、false

戻り値

カルチャの読み取り専用インスタンス。

注釈

既定では、カルチャを作成しようとして、基になるプラットフォーム (Windows NLS または ICU) にこのカルチャの特定のデータが含まれていない場合、プラットフォームは他のカルチャまたは定数値のデータを使用してカルチャを構築しようとします。

を にtrue設定predefinedOnlyすると、プラットフォームにそのカルチャの実際のデータがある場合にのみカルチャが作成されます。

適用対象

GetCultureInfo(String, String)

カルチャのキャッシュされた読み取り専用インスタンスを取得します。 パラメーターは、別のカルチャで指定された TextInfo オブジェクトおよび CompareInfo オブジェクトで初期化されたカルチャを指定します。

public:
 static System::Globalization::CultureInfo ^ GetCultureInfo(System::String ^ name, System::String ^ altName);
public static System.Globalization.CultureInfo GetCultureInfo (string name, string altName);
static member GetCultureInfo : string * string -> System.Globalization.CultureInfo
Public Shared Function GetCultureInfo (name As String, altName As String) As CultureInfo

パラメーター

name
String

カルチャの名前。 name では、大文字と小文字は区別されません。

altName
String

name の初期化に使用される TextInfo オブジェクトおよび CompareInfo オブジェクトを提供するカルチャの名前。 altName では、大文字と小文字は区別されません。

戻り値

読み取り専用の CultureInfo オブジェクト。

例外

name または altName が null です。

name または altName は、サポートされていないカルチャを指定しています。 詳細については、「呼び出し時の注意」をご覧ください。

注釈

Windows システム上の定義済みのカルチャ名の一覧については、Windows でサポートされている言語/地域名の一覧の言語タグ列を参照してください。 カルチャ名は、BCP 47 によって定義されている標準に準拠します。 また、Windows 10 以降では、name任意の有効な BCP-47 言語タグを指定できます。

メソッドは GetCultureInfo 、キャッシュされた読み取り専用 CultureInfo オブジェクトを取得します。 コンストラクターへの対応する呼び出しよりもパフォーマンスが CultureInfo 向上します。 メソッドは、 パラメーターで指定されたカルチャと同様のカルチャを name 作成するために使用されますが、並べ替え規則と大文字と小文字の規則が異なります。

または altName が現在のカルチャの名前の場合name、返されるオブジェクトにはユーザーのオーバーライドは反映されません。 が のString.Empty場合name、メソッドはインバリアント カルチャを返します。 これは、 プロパティの InvariantCulture 値を取得することと同じです。 が String.Emptyの場合altName、メソッドはインバリアント カルチャで指定された書き込みシステムと比較規則を使用します。

注意 (呼び出し元)

.NET Framework 3.5 以前のバージョンでは、 ArgumentException または altName が有効なカルチャ名でない場合nameは がスローされます。 .NET Framework 4 以降では、このメソッドは をCultureNotFoundExceptionスローします。 Windows 7 以降で.NET Framework 4 以降で実行されるアプリ以降、メソッドはnameオペレーティング システムから識別子を持つオブジェクトの取得CultureInfoを試みます。オペレーティング システムがそのカルチャをサポートしていない場合、および が補助カルチャまたは置換カルチャの名前でない場合name、メソッドは例外をCultureNotFoundExceptionスローします。

.NET 6 以降のバージョンでは、 CultureNotFoundException グローバリゼーションインバリアント モードが有効になっている環境でアプリが実行されている場合 (たとえば、一部の Docker コンテナーや、インバリアント カルチャ以外のカルチャが指定されている場合)、 がスローされます。

こちらもご覧ください

適用対象

GetCultureInfo(Int32)

指定されたカルチャ識別子を使用して、カルチャのキャッシュされた読み取り専用インスタンスを取得します。

public:
 static System::Globalization::CultureInfo ^ GetCultureInfo(int culture);
public static System.Globalization.CultureInfo GetCultureInfo (int culture);
static member GetCultureInfo : int -> System.Globalization.CultureInfo
Public Shared Function GetCultureInfo (culture As Integer) As CultureInfo

パラメーター

culture
Int32

ロケール識別子 (LCID)。

戻り値

読み取り専用の CultureInfo オブジェクト。

例外

culture が 0 未満です。

culture はサポートされていないカルチャを指定します。 詳細については、「呼び出し時の注意」をご覧ください。

注釈

LCID の代わりにロケール名を使用する必要があるため、このメソッド (GetCultureInfo(String)) の文字列オーバーロードを使用することをお勧めします。 カスタム ロケールの場合は、ロケール名が必要です。

が現在のカルチャのロケール識別子の場合 culture 、返される CultureInfo オブジェクトにはユーザーのオーバーライドは反映されません。

注意 (呼び出し元)

.NET Framework 3.5 以前のバージョンでは、 が有効なカルチャ識別子でない場合cultureは がスローArgumentExceptionされます。 .NET Framework 4 以降では、このメソッドは をCultureNotFoundExceptionスローします。 Windows 7 以降で .NET Framework 4 以降で実行されるアプリ以降、メソッドはculture、オペレーティング システムから識別子を持つオブジェクトの取得CultureInfoを試みます。オペレーティング システムがそのカルチャをサポートしていない場合、メソッドは をCultureNotFoundExceptionスローします。

.NET 6 以降のバージョンでは、 CultureNotFoundException グローバリゼーションインバリアント モードが有効になっている環境でアプリが実行されている場合 (たとえば、一部の Docker コンテナーや、インバリアント カルチャ以外のカルチャが指定されている場合)、 がスローされます。

こちらもご覧ください

適用対象

GetCultureInfo(String)

指定されたカルチャ名を使用して、カルチャのキャッシュされた読み取り専用インスタンスを取得します。

public:
 static System::Globalization::CultureInfo ^ GetCultureInfo(System::String ^ name);
public static System.Globalization.CultureInfo GetCultureInfo (string name);
static member GetCultureInfo : string -> System.Globalization.CultureInfo
Public Shared Function GetCultureInfo (name As String) As CultureInfo

パラメーター

name
String

カルチャの名前。 name では、大文字と小文字は区別されません。

戻り値

読み取り専用の CultureInfo オブジェクト。

例外

name が null です。

name はサポートされていないカルチャを指定します。 詳細については、「呼び出し時の注意」をご覧ください。

注釈

Windows システム上の定義済みのカルチャ名の一覧については、Windows でサポートされている言語/地域名の一覧の言語タグ列を参照してください。 カルチャ名は、BCP 47 によって定義されている標準に準拠します。 また、Windows 10 以降では、name任意の有効な BCP-47 言語タグを指定できます。

メソッドは GetCultureInfo 、キャッシュされた読み取り専用 CultureInfo オブジェクトを取得します。 コンストラクターの対応する呼び出しよりもパフォーマンスが CultureInfo.CultureInfo(String) 向上します。

が現在のカルチャの名前の場合 name 、返される CultureInfo オブジェクトにはユーザーのオーバーライドは反映されません。 これにより、 メソッドは、システム上に実際のユーザー アカウントを持たず、複数のカルチャを効率的に読み込む必要があるサーバー アプリケーションまたはツールに適しています。

が のString.Empty場合name、メソッドはインバリアント カルチャを返します。 これは、 プロパティの InvariantCulture 値を取得することと同じです。

注意 (呼び出し元)

.NET Framework 3.5 以前のバージョンでは、 が有効なカルチャ名でない場合nameは がスローArgumentExceptionされます。 .NET Framework 4 以降では、このメソッドは をCultureNotFoundExceptionスローします。 Windows 7 以降で .NET Framework 4 以降で実行されるアプリ以降では、オペレーティング システムから識別子nameを持つオブジェクトの取得CultureInfoが試行されます。オペレーティング システムがそのカルチャをサポートしていない場合、および が補助カルチャまたは置換カルチャの名前でない場合name、メソッドは をCultureNotFoundExceptionスローします。

.NET 6 以降のバージョンでは、 CultureNotFoundException グローバリゼーションインバリアント モードが有効になっている環境でアプリが実行されている場合 (たとえば、一部の Docker コンテナーや、インバリアント カルチャ以外のカルチャが指定されている場合)、 がスローされます。

こちらもご覧ください

適用対象