CultureInfo.GetCultureInfo 메서드

정의

네임스페이스:

System.Globalization

어셈블리:

System.Runtime.dll

문화권의 캐시된 읽기 전용 인스턴스를 검색합니다.

오버로드

GetCultureInfo(String, Boolean)	문화권의 캐시된 읽기 전용 인스턴스를 검색합니다.
GetCultureInfo(String, String)	문화권의 캐시된 읽기 전용 인스턴스를 검색합니다. 매개 변수는 다른 문화권이 지정하는 TextInfo 및 CompareInfo 개체를 사용하여 초기화되는 문화권을 지정합니다.
GetCultureInfo(Int32)	지정된 문화권 식별자를 사용하여 문화권의 캐시된 읽기 전용 인스턴스를 검색합니다.
GetCultureInfo(String)	지정된 문화권 이름을 사용하여 문화권의 캐시된 읽기 전용 인스턴스를 검색합니다.

GetCultureInfo(String, Boolean)

Source:

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

매개 변수

name

String

문화권의 이름입니다. 대/소문자를 구분하지 않습니다.

predefinedOnly

Boolean

플랫폼에 알려진 문화권의 인스턴스를 만들도록 요청하는 경우 true입니다. 플랫폼에 해당 데이터가 없더라도 구성된 문화권이 검색되는 것이 상관없으면 false입니다.

반환

CultureInfo

문화권의 읽기 전용 instance.

설명

기본적으로 문화권을 만들려고 할 때 기본 플랫폼(Windows NLS 또는 ICU)이 이 문화권에 대한 특정 데이터를 전달하지 않는 경우 플랫폼은 다른 문화권 또는 일부 상수 값의 데이터로 문화권을 생성하려고 합니다.

를 로 true 설정 predefinedOnly 하면 플랫폼에 해당 문화권에 대한 실제 데이터가 있는 경우에만 문화권이 만들어집니다.

GetCultureInfo(String, String)

Source:

CultureInfo.cs

문화권의 캐시된 읽기 전용 인스턴스를 검색합니다. 매개 변수는 다른 문화권이 지정하는 TextInfo 및 CompareInfo 개체를 사용하여 초기화되는 문화권을 지정합니다.

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

문화권의 이름입니다. name은(는) 대/소문자를 구분하지 않습니다.

altName

String

name을 초기화하는 데 사용된 TextInfo 및 CompareInfo 개체를 제공하는 문화권 이름입니다. altName은(는) 대/소문자를 구분하지 않습니다.

반환

CultureInfo

읽기 전용 CultureInfo 개체입니다.

예외

ArgumentNullException

name 또는 altName가 null입니다.

CultureNotFoundException

name 또는 altName이 지원되지 않는 문화권을 지정할 경우 자세한 내용은 호출자 참고 사항을 참조하세요.

설명

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

.NET 6 이상 버전 CultureNotFoundException 에서는 앱이 세계화 고정 모드(예: 일부 Docker 컨테이너) 및 고정 문화권 이외의 문화권이 지정된 환경에서 실행 중인 경우 이 throw됩니다.

추가 정보

• Name
• ClearCachedData()

GetCultureInfo(Int32)

Source:

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

매개 변수

culture

Int32

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

반환

CultureInfo

읽기 전용 CultureInfo 개체입니다.

예외

ArgumentOutOfRangeException

culture가 0보다 작은 경우

CultureNotFoundException

culture가 지원되지 않는 문화권을 지정할 경우 자세한 내용은 호출자 참고 사항 섹션을 참조하세요.

설명

로캘 이름은 LCID 대신 사용해야 하므로 이 메서드(GetCultureInfo(String))의 문자열 오버로드를 사용하는 것이 좋습니다. 사용자 지정 로캘의 경우 로캘 이름이 필요합니다.

가 현재 문화권의 로캘 식별자인 경우 culture 반환된 CultureInfo 개체는 사용자 재정의를 반영하지 않습니다.

호출자 참고

.NET Framework 3.5 이전 버전에서는 가 유효한 문화권 식별자가 아닌 경우 culture 를 throw ArgumentException 합니다. .NET Framework 4부터 이 메서드는 을 CultureNotFoundExceptionthrow합니다. Windows 7 이상에서 .NET Framework 4 이상에서 실행되는 앱부터 메서드는 culture 운영 체제에서 식별자가 있는 개체를 검색 CultureInfo 하려고 시도합니다. 운영 체제에서 해당 문화권을 지원하지 않는 경우 메서드는 을 CultureNotFoundExceptionthrow합니다.

.NET 6 이상 버전 CultureNotFoundException 에서는 앱이 세계화 고정 모드(예: 일부 Docker 컨테이너) 및 고정 문화권 이외의 문화권이 지정된 환경에서 실행 중인 경우 이 throw됩니다.

추가 정보

• LCID
• ClearCachedData()

GetCultureInfo(String)

Source:

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

매개 변수

name

String

문화권의 이름입니다. name은(는) 대/소문자를 구분하지 않습니다.

반환

CultureInfo

읽기 전용 CultureInfo 개체입니다.

예외

ArgumentNullException

name가 null입니다.

CultureNotFoundException

name가 지원되지 않는 문화권을 지정할 경우 자세한 내용은 호출자 참고 사항을 참조하세요.

설명

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 를 throw ArgumentException 합니다. .NET Framework 4부터 이 메서드는 을 CultureNotFoundExceptionthrow합니다. Windows 7 이상에서 .NET Framework 4 이상에서 실행되는 앱부터 메서드는 name 운영 체제에서 식별자가 있는 개체를 검색 CultureInfo 하려고 시도합니다. 운영 체제에서 해당 문화권을 지원하지 않는 경우 이 보충 문화권 또는 대체 문화권의 이름이 아닌 경우 name 메서드는 을 CultureNotFoundExceptionthrow합니다.

.NET 6 이상 버전 CultureNotFoundException 에서는 앱이 세계화 고정 모드(예: 일부 Docker 컨테이너) 및 고정 문화권 이외의 문화권이 지정된 환경에서 실행 중인 경우 이 throw됩니다.

추가 정보

• Name