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. 매개 변수는 다른 문화권이 지정하는 TextInfoCompareInfo 개체를 사용하여 초기화되는 문화권을 지정합니다.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.

설명

이 메서드의 문자열 오버 로드를 사용 하는 것이 좋습니다 (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 이전 버전에서 throw 하 고는 ArgumentException 경우 culture 유효한 문화권 식별자가 아닙니다.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. 실행 되는 앱부터 합니다 .NET Framework 4.NET Framework 4 나중에 Windows 7 이상에서 메서드를 검색 하려고 하거나를 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.

추가 정보

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 이전 버전에서 throw 하 고는 ArgumentException 경우 name 유효한 문화권 이름이 아닙니다.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. 실행 되는 앱부터 합니다 .NET Framework 4.NET Framework 4 나중에 Windows 7 이상에서 메서드를 검색 하려고 시도 하거나를 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.

추가 정보

GetCultureInfo(String, String) GetCultureInfo(String, String) GetCultureInfo(String, String) 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 String String String

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

altName
String String String 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. 하는 경우 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 이전 버전에서 throw 하 고는 ArgumentException 경우 name 또는 altName 유효한 문화권 이름이 아닙니다.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. 실행 되는 앱부터 합니다 .NET Framework 4.NET Framework 4 나중에 Windows 7 이상에서 메서드를 검색 하려고 시도 하거나를 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. 실행 되는 앱부터 합니다 .NET Framework 4.NET Framework 4 나중에 Windows 7 이상에서 메서드를 검색 하려고 시도 하거나를 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.

추가 정보

적용 대상