CultureInfo.GetCultureInfo 메서드

정의

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

오버로드

GetCultureInfo(String, Boolean)

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

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.

GetCultureInfo(String)

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

GetCultureInfo(String, Boolean)

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

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

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

predefinedOnly
Boolean

플랫폼에 알려진 문화권의 인스턴스를 만들도록 요청하는 경우 true입니다.true if requesting to create an instance of a culture that is known by the platform. 플랫폼에 해당 데이터가 없더라도 구성된 문화권이 검색되는 것이 상관없으면 false입니다.false if it is ok to retreive a made-up culture even if the platform does not carry data for it.

반환

CultureInfo

문화권의 읽기 전용 인스턴스입니다.A read-only instance of a culture.

설명

기본적으로 문화권을 만들려고 할 때 기본 플랫폼 (Windows NLS 또는 ICU)이이 문화권에 대 한 특정 데이터를 전달 하지 않는 경우 플랫폼은 다른 문화권 또는 일부 상수 값의 데이터를 사용 하 여 문화권을 생성 하려고 합니다.By default, when trying to create any culture and the underlying platform (Windows NLS or ICU) does not carry specific data for this culture, the platform will try constructing a culture with data from other cultures or some constant values.

predefinedOnly로 설정 true 하면 플랫폼에 해당 문화권에 대 한 실제 데이터가 있는 경우에만 문화권이 생성 됩니다.Setting predefinedOnly to true will ensure a culture is created only if the platform has real data for that culture.

적용 대상

제품 Introduced

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

읽기 전용 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.

호출자 참고

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

추가 정보

적용 대상

제품 Introduced

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

읽기 전용 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.

설명

GetCultureInfo(String)Lcid 대신 로캘 이름을 사용 해야 하기 때문에이 메서드의 문자열 오버 로드 ()를 사용 하는 것이 좋습니다.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및 이전 버전은 ArgumentException culture 가 올바른 문화권 식별자가 아닌 경우을 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 이 메서드는을 throw CultureNotFoundException 합니다.Starting with the .NET Framework 4.NET Framework 4, this method throws a CultureNotFoundException. Windows 7 이상 버전에서 실행 되는 앱부터 .NET Framework 4.NET Framework 4 메서드는 CultureInfo 운영 체제에서 식별자가 있는 개체를 검색 하려고 culture 합니다. 운영 체제에서 해당 문화권을 지원 하지 않는 경우 메서드는을 throw 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.

추가 정보

적용 대상

제품 Introduced

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

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

추가 정보

적용 대상

제품 Introduced