CultureInfo.GetCultureInfo CultureInfo.GetCultureInfo CultureInfo.GetCultureInfo CultureInfo.GetCultureInfo Method

定義

カルチャのキャッシュされた読み取り専用インスタンスを取得します。Retrieves a cached, read-only instance of a culture.

オーバーロード

GetCultureInfo(Int32) GetCultureInfo(Int32) GetCultureInfo(Int32) GetCultureInfo(Int32)

指定されたカルチャ識別子を使用して、カルチャのキャッシュされた読み取り専用インスタンスを取得します。Retrieves a cached, read-only instance of a culture by using the specified culture identifier.

GetCultureInfo(String) GetCultureInfo(String) GetCultureInfo(String) GetCultureInfo(String)

指定されたカルチャ名を使用して、カルチャのキャッシュされた読み取り専用インスタンスを取得します。Retrieves a cached, read-only instance of a culture using the specified culture name.

GetCultureInfo(String, String) GetCultureInfo(String, String) GetCultureInfo(String, String) GetCultureInfo(String, String)

カルチャのキャッシュされた読み取り専用インスタンスを取得します。Retrieves a cached, read-only instance of a culture. パラメーターは、別のカルチャで指定された TextInfo オブジェクトおよび CompareInfo オブジェクトで初期化されたカルチャを指定します。Parameters specify a culture that is initialized with the TextInfo and CompareInfo objects specified by another culture.

GetCultureInfo(Int32) GetCultureInfo(Int32) GetCultureInfo(Int32) GetCultureInfo(Int32)

指定されたカルチャ識別子を使用して、カルチャのキャッシュされた読み取り専用インスタンスを取得します。Retrieves a cached, read-only instance of a culture by using the specified culture identifier.

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 Int32 Int32 Int32

ロケール識別子 (LCID)。A locale identifier (LCID).

戻り値

読み取り専用の CultureInfo オブジェクト。A read-only CultureInfo object.

例外

culture は、サポートされていないカルチャを指定しています。culture specifies a culture that is not supported. 詳細については、「呼び出し時の注意」をご覧ください。See the Notes to Caller section for more information.

注釈

Lcid の代わりにロケール名を使用する必要があるGetCultureInfo(String)ため、このメソッド () の文字列オーバーロードを使用することをお勧めします。We recommend that you use the string overload of this method (GetCultureInfo(String)), because locale names should be used instead of LCIDs. カスタムロケールの場合は、ロケール名が必要です。For custom locales, the locale name is required.

culture現在のカルチャのロケール識別子である場合、返さCultureInfoれるオブジェクトにはユーザーのオーバーライドは反映されません。If culture is the locale identifier of the current culture, the returned CultureInfo object does not reflect any user overrides.

注意 (呼び出し元)

以前.NET Framework 3.5.NET Framework 3.5のバージョンでは、 ArgumentExceptionculture有効なカルチャ識別子でない場合、がスローされます。The .NET Framework 3.5.NET Framework 3.5 and earlier versions throw an ArgumentException if culture is not a valid culture identifier. 以降では、このメソッドはをCultureNotFoundExceptionスローします。 .NET Framework 4.NET Framework 4Starting with the .NET Framework 4.NET Framework 4, this method throws a CultureNotFoundException. 以降の.NET Framework 4.NET Framework 4 Windows 7 以降で実行されるアプリ以降では、メソッドは、オペレーティングシステムからのCultureInfo識別子をculture持つオブジェクトを取得しようとします。オペレーティングシステムがそのカルチャをサポートしていない場合、メソッドはをCultureNotFoundExceptionスローします。Starting with apps that run under the .NET Framework 4.NET Framework 4 or later on Windows 7 or later, the method attempts to retrieve a CultureInfo object whose identifier is culture from the operating system; if the operating system does not support that culture, the method throws a CultureNotFoundException.

こちらもご覧ください

GetCultureInfo(String) GetCultureInfo(String) GetCultureInfo(String) GetCultureInfo(String)

指定されたカルチャ名を使用して、カルチャのキャッシュされた読み取り専用インスタンスを取得します。Retrieves a cached, read-only instance of a culture using the specified culture name.

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 String String String

カルチャの名前。The name of a culture. name では、大文字と小文字は区別されません。name is not case-sensitive.

戻り値

読み取り専用の CultureInfo オブジェクト。A read-only CultureInfo object.

例外

name は、サポートされていないカルチャを指定しています。name specifies a culture that is not supported. 詳細については、「呼び出し時の注意」をご覧ください。See the Notes to Callers section for more information.

注釈

Windows システム上の定義済みカルチャ名の一覧については、 windows でサポートされている言語/地域名の一覧[言語タグ] 列を参照してください。For a list of predefined culture names on Windows systems, see the Language tag column in the list of language/region names supported by Windows. カルチャ名は、BCP 47 によって定義されている標準に準拠します。Culture names follow the standard defined by BCP 47. さらに、Windows 10 以降ではname 、有効な BCP-47 言語タグを使用できます。In addition, starting with Windows 10, name can be any valid BCP-47 language tag.

メソッドGetCultureInfoは、キャッシュされた読み取りCultureInfo専用のオブジェクトを取得します。The GetCultureInfo method retrieves a cached, read-only CultureInfo object. コンストラクターへのCultureInfo.CultureInfo(String)対応する呼び出しよりもパフォーマンスが優れています。It offers better performance than a corresponding call to the CultureInfo.CultureInfo(String) constructor.

name現在のカルチャの名前である場合、返さCultureInfoれるオブジェクトにはユーザーのオーバーライドは反映されません。If name is the name of the current culture, the returned CultureInfo object does not reflect any user overrides. これにより、システム上に実際のユーザーアカウントを持たず、複数のカルチャを効率的に読み込む必要があるサーバーアプリケーションやツールに適した方法になります。This makes the method suitable for server applications or tools that do not have a real user account on the system and that need to load multiple cultures efficiently.

nameString.Emptyの場合、メソッドはインバリアントカルチャを返します。If name is String.Empty, the method returns the invariant culture. これは、 InvariantCultureプロパティの値を取得することと同じです。This is equivalent to retrieving the value of the InvariantCulture property.

注意 (呼び出し元)

以前.NET Framework 3.5.NET Framework 3.5のバージョンでは、 ArgumentExceptionname有効なカルチャ名でない場合、がスローされます。The .NET Framework 3.5.NET Framework 3.5 and earlier versions throw an ArgumentException if name is not a valid culture name. 以降では、このメソッドはをCultureNotFoundExceptionスローします。 .NET Framework 4.NET Framework 4Starting with the .NET Framework 4.NET Framework 4, this method throws a CultureNotFoundException. 以降の.NET Framework 4.NET Framework 4 Windows 7 以降で実行されるアプリ以降では、メソッドは、オペレーティングシステムからのCultureInfo識別子をname持つオブジェクトを取得しようとします。オペレーティングシステムがそのカルチャをサポートしていない場合は、は、補助カルチャまたは置換カルチャの名前ではありませんCultureNotFoundException。メソッドはをスローします。 nameStarting with apps that run under the .NET Framework 4.NET Framework 4 or later on Windows 7 or later, the method attempts to retrieve a CultureInfo object whose identifier is name from the operating system; if the operating system does not support that culture, and if name is not the name of a supplementary or replacement culture, the method throws a CultureNotFoundException.

こちらもご覧ください

GetCultureInfo(String, String) GetCultureInfo(String, String) GetCultureInfo(String, String) GetCultureInfo(String, String)

カルチャのキャッシュされた読み取り専用インスタンスを取得します。Retrieves a cached, read-only instance of a culture. パラメーターは、別のカルチャで指定された TextInfo オブジェクトおよび CompareInfo オブジェクトで初期化されたカルチャを指定します。Parameters specify a culture that is initialized with the TextInfo and CompareInfo objects specified by another culture.

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 String String String

カルチャの名前。The name of a culture. name では、大文字と小文字は区別されません。name is not case-sensitive.

altName
String String String String

name の初期化に使用される TextInfo オブジェクトおよび CompareInfo オブジェクトを提供するカルチャの名前。The name of a culture that supplies the TextInfo and CompareInfo objects used to initialize name. altName では、大文字と小文字は区別されません。altName is not case-sensitive.

戻り値

読み取り専用の CultureInfo オブジェクト。A read-only CultureInfo object.

例外

name または altName が null です。name or altName is null.

name または altName は、サポートされていないカルチャを指定しています。name or altName specifies a culture that is not supported. 詳細については、「呼び出し時の注意」をご覧ください。See the Notes to Callers section for more information.

注釈

Windows システム上の定義済みカルチャ名の一覧については、 windows でサポートされている言語/地域名の一覧[言語タグ] 列を参照してください。For a list of predefined culture names on Windows systems, see the Language tag column in the list of language/region names supported by Windows. カルチャ名は、BCP 47 によって定義されている標準に準拠します。Culture names follow the standard defined by BCP 47. さらに、Windows 10 以降ではname 、有効な BCP-47 言語タグを使用できます。In addition, starting with Windows 10, name can be any valid BCP-47 language tag.

メソッドGetCultureInfoは、キャッシュされた読み取りCultureInfo専用のオブジェクトを取得します。The GetCultureInfo method obtains a cached, read-only CultureInfo object. CultureInfoコンストラクターへの対応する呼び出しよりもパフォーマンスが優れています。It offers better performance than a corresponding call to a CultureInfo constructor. メソッドは、 nameパラメーターで指定されたものと類似したカルチャを作成するために使用されますが、並べ替え規則と大文字小文字の規則は異なります。The method is used to create a culture similar to that specified by the name parameter, but with different sorting and casing rules.

name またaltNameはが現在のカルチャの名前である場合、返されるオブジェクトにはユーザーのオーバーライドは反映されません。If name or altName is the name of the current culture, the returned objects do not reflect any user overrides. nameString.Emptyの場合、メソッドはインバリアントカルチャを返します。If name is String.Empty, the method returns the invariant culture. これは、 InvariantCultureプロパティの値を取得することと同じです。This is equivalent to retrieving the value of the InvariantCulture property. altNameString.Emptyの場合、メソッドは、インバリアントカルチャによって指定された書記体系と比較規則を使用します。If altName is String.Empty, the method uses the writing system and comparison rules specified by the invariant culture.

注意 (呼び出し元)

以前.NET Framework 3.5.NET Framework 3.5のバージョンでは、 ArgumentExceptionまたnamealtNameが有効なカルチャ名でない場合、がスローされます。The .NET Framework 3.5.NET Framework 3.5 and earlier versions throw an ArgumentException if name or altName is not a valid culture name. 以降では、このメソッドはをCultureNotFoundExceptionスローします。 .NET Framework 4.NET Framework 4Starting with the .NET Framework 4.NET Framework 4, this method throws a CultureNotFoundException. 以降の.NET Framework 4.NET Framework 4 Windows 7 以降で実行されるアプリ以降では、メソッドは、オペレーティングシステムからのCultureInfo識別子をname持つオブジェクトを取得しようとします。オペレーティングシステムがそのカルチャをサポートしていない場合は、は、補助カルチャまたは置換カルチャの名前ではありませんCultureNotFoundException 。メソッドは例外をスローします。 nameStarting with apps that run under the .NET Framework 4.NET Framework 4 or later on Windows 7 or later, the method attempts to retrieve a CultureInfo object whose identifier is name from the operating system; if the operating system does not support that culture, and if name is not the name of a supplementary or replacement culture, the method throws a CultureNotFoundException exception. 以降の.NET Framework 4.NET Framework 4 Windows 7 以降で実行されるアプリ以降では、メソッドは、オペレーティングシステムからのCultureInfo識別子をname持つオブジェクトを取得しようとします。オペレーティングシステムがそのカルチャをサポートしていない場合は、は、補助カルチャまたは置換カルチャの名前ではありませんCultureNotFoundException 。メソッドは例外をスローします。 nameStarting with apps that run under the .NET Framework 4.NET Framework 4 or later on Windows 7 or later, the method attempts to retrieve a CultureInfo object whose identifier is name from the operating system; if the operating system does not support that culture, and if name is not the name of a supplementary or replacement culture, the method throws a CultureNotFoundException exception.

こちらもご覧ください

適用対象