CultureInfo.GetCultureInfo 메서드

정의

문화권의 캐시된 읽기 전용 인스턴스를 검색합니다.Retrieves a cached, read-only instance of a culture.

오버로드

GetCultureInfo(Int32)

지정된 문화권 식별자를 사용하여 문화권의 캐시된 읽기 전용 인스턴스를 검색합니다.Retrieves a cached, read-only instance of a culture by using the specified culture identifier.

GetCultureInfo(String)

지정된 문화권 이름을 사용하여 문화권의 캐시된 읽기 전용 인스턴스를 검색합니다.Retrieves a cached, read-only instance of a culture using the specified culture name.

GetCultureInfo(String, String)

문화권의 캐시된 읽기 전용 인스턴스를 검색합니다.Retrieves a cached, read-only instance of a culture. 매개 변수는 다른 문화권이 지정하는 TextInfoCompareInfo 개체를 사용하여 초기화되는 문화권을 지정합니다.Parameters specify a culture that is initialized with the TextInfo and CompareInfo objects specified by another culture.

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

LCID(로캘 식별자)입니다.A locale identifier (LCID).

반환

읽기 전용 CultureInfo 개체입니다.A read-only CultureInfo object.

예외

culture가 0보다 작은 경우culture is less than zero.

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와 이전 버전은 culture가 올바른 문화권 식별자가 아닌 경우 ArgumentException을 throw 합니다.The .NET Framework 3.5.NET Framework 3.5 and earlier versions throw an ArgumentException if culture is not a valid culture identifier. .NET Framework 4.NET Framework 4부터이 메서드는 CultureNotFoundException를 throw 합니다.Starting with the .NET Framework 4.NET Framework 4, this method throws a CultureNotFoundException. Windows 7 이상에서 .NET Framework 4.NET Framework 4 이상에서 실행 되는 앱부터 메서드는 식별자가 운영 체제에서 culture 되는 CultureInfo 개체를 검색 하려고 합니다. 운영 체제에서 해당 문화권을 지원 하지 않는 경우 메서드는 CultureNotFoundException을 throw 합니다.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)

지정된 문화권 이름을 사용하여 문화권의 캐시된 읽기 전용 인스턴스를 검색합니다.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

문화권의 이름입니다.The name of a culture. name은(는) 대/소문자를 구분하지 않습니다.name is not case-sensitive.

반환

읽기 전용 CultureInfo 개체입니다.A read-only CultureInfo object.

예외

name가 null입니다.name is null.

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.

name String.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와 이전 버전은 name가 올바른 문화권 이름이 아닌 경우 ArgumentException을 throw 합니다.The .NET Framework 3.5.NET Framework 3.5 and earlier versions throw an ArgumentException if name is not a valid culture name. .NET Framework 4.NET Framework 4부터이 메서드는 CultureNotFoundException를 throw 합니다.Starting with the .NET Framework 4.NET Framework 4, this method throws a CultureNotFoundException. Windows 7 이상에서 .NET Framework 4.NET Framework 4 이상에서 실행 되는 앱부터 메서드는 식별자가 운영 체제에서 name 되는 CultureInfo 개체를 검색 하려고 합니다. 운영 체제에서 해당 문화권을 지원 하지 않는 경우 name이 보충 또는 대체 문화권의 이름이 아닌 경우 메서드는 CultureNotFoundException를 throw 합니다.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 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)

문화권의 캐시된 읽기 전용 인스턴스를 검색합니다.Retrieves a cached, read-only instance of a culture. 매개 변수는 다른 문화권이 지정하는 TextInfoCompareInfo 개체를 사용하여 초기화되는 문화권을 지정합니다.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

문화권의 이름입니다.The name of a culture. name은(는) 대/소문자를 구분하지 않습니다.name is not case-sensitive.

altName
String

name을 초기화하는 데 사용된 TextInfoCompareInfo 개체를 제공하는 문화권 이름입니다.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. name String.Empty되는 경우 메서드는 고정 문화권을 반환 합니다.If name is String.Empty, the method returns the invariant culture. 이는 InvariantCulture 속성의 값을 검색 하는 것과 같습니다.This is equivalent to retrieving the value of the InvariantCulture property. altName String.Empty되는 경우 메서드는 고정 문화권에 지정 된 쓰기 시스템 및 비교 규칙을 사용 합니다.If altName is String.Empty, the method uses the writing system and comparison rules specified by the invariant culture.

호출자 참고

name 또는 altName 올바른 문화권 이름이 아닌 경우 .NET Framework 3.5.NET Framework 3.5 이전 버전은 ArgumentException을 throw 합니다.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. .NET Framework 4.NET Framework 4부터이 메서드는 CultureNotFoundException를 throw 합니다.Starting with the .NET Framework 4.NET Framework 4, this method throws a CultureNotFoundException. Windows 7 이상에서 .NET Framework 4.NET Framework 4 이상에서 실행 되는 앱부터 메서드는 식별자가 운영 체제에서 name 되는 CultureInfo 개체를 검색 하려고 합니다. 운영 체제에서 해당 문화권을 지원 하지 않는 경우 name이 보충 또는 대체 문화권의 이름이 아닌 경우 메서드는 CultureNotFoundException 예외를 throw 합니다.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 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. Windows 7 이상에서 .NET Framework 4.NET Framework 4 이상에서 실행 되는 앱부터 메서드는 식별자가 운영 체제에서 name 되는 CultureInfo 개체를 검색 하려고 합니다. 운영 체제에서 해당 문화권을 지원 하지 않는 경우 name이 보충 또는 대체 문화권의 이름이 아닌 경우 메서드는 CultureNotFoundException 예외를 throw 합니다.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 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.

추가 정보

적용 대상