CultureInfo.GetCultureInfo メソッド

ソース:

CultureInfo.cs

ソース:

CultureInfo.cs

ソース:

CultureInfo.cs

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

パラメーター

戻り値

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

注釈

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

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

ソース:

CultureInfo.cs

ソース:

CultureInfo.cs

ソース:

CultureInfo.cs

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

パラメーター

戻り値

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

例外

注釈

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 コンテナーや、インバリアント カルチャ以外のカルチャが指定されている場合)、 がスローされます。

こちらもご覧ください

• Name
• ClearCachedData()

ソース:

CultureInfo.cs

ソース:

CultureInfo.cs

ソース:

CultureInfo.cs

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

パラメーター

戻り値

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

例外

注釈

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 コンテナーや、インバリアント カルチャ以外のカルチャが指定されている場合)、 がスローされます。

こちらもご覧ください

• LCID
• ClearCachedData()

ソース:

CultureInfo.cs

ソース:

CultureInfo.cs

ソース:

CultureInfo.cs

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

パラメーター

戻り値

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

例外

注釈

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 コンテナーや、インバリアント カルチャ以外のカルチャが指定されている場合)、 がスローされます。

こちらもご覧ください

• Name