CultureInfo 생성자

정의

CultureInfo 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the CultureInfo class.

오버로드

CultureInfo(Int32)

문화권 식별자별로 지정된 문화권을 기반으로 하는 CultureInfo 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the CultureInfo class based on the culture specified by the culture identifier.

CultureInfo(String)

이름에 지정된 문화권을 기반으로 CultureInfo 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the CultureInfo class based on the culture specified by name.

CultureInfo(Int32, Boolean)

사용자가 시스템에서 선택한 문화권 설정을 사용할지 여부를 지정하는 부울과 문화권 식별자별로 지정된 문화권을 기반으로 하는 CultureInfo 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the CultureInfo class based on the culture specified by the culture identifier and on the Boolean that specifies whether to use the user-selected culture settings from the system.

CultureInfo(String, Boolean)

사용자가 시스템에서 선택한 문화권 설정을 사용할지 여부를 지정하는 부울과 이름별로 지정된 문화권을 기반으로 하는 CultureInfo 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the CultureInfo class based on the culture specified by name and on the Boolean that specifies whether to use the user-selected culture settings from the system.

CultureInfo(Int32)

문화권 식별자별로 지정된 문화권을 기반으로 하는 CultureInfo 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the CultureInfo class based on the culture specified by the culture identifier.

public:
 CultureInfo(int culture);
public CultureInfo (int culture);
new System.Globalization.CultureInfo : int -> System.Globalization.CultureInfo
Public Sub New (culture As Integer)

매개 변수

culture
Int32

미리 정의된 CultureInfo 식별자, 기존 LCID 개체의 CultureInfo 속성 또는 Windows 전용 문화권 식별자입니다.A predefined CultureInfo identifier, LCID property of an existing CultureInfo object, or Windows-only culture identifier.

예외

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

culture가 올바른 문화권 식별자가 아닙니다.culture is not a valid culture identifier. 자세한 내용은 호출자 참고 사항을 참조하세요.See the Notes to Callers section for more information.

설명

Windows 시스템에서 사용할 수 있는 문화권의 미리 정의 된 문화권 식별자는 windows에서 지 원하는 언어/지역 이름 목록의 언어 태그 열에 나열 됩니다.Predefined culture identifiers for cultures available on Windows system are listed in 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.

대부분의 경우 culture 매개 변수는 해당 하는 NLS (국가별 언어 지원) 로캘 식별자에 매핑됩니다.In most cases, the culture parameter is mapped to the corresponding National Language Support (NLS) locale identifier. 매개 변수의 값은 culture 새의 속성 값이 됩니다 LCID CultureInfo .The value of the culture parameter becomes the value of the LCID property of the new CultureInfo.

로캘 이름은 Lcid 보다 선호 되므로 로캘 이름 생성자를 호출 하는 것이 좋습니다 CultureInfo.CultureInfo .We recommend that you call the locale name constructor CultureInfo.CultureInfo, because locale names are preferable to LCIDs. 사용자 지정 로캘의 경우 로캘 이름이 필요 합니다.For custom locales, a locale name is required.

사용자는 제어판의 국가 및 언어 옵션을 통해 Windows의 현재 문화권과 연결 된 값 중 일부를 재정의 하도록 선택할 수 있습니다.The user might choose to override some of the values associated with the current culture of Windows through the regional and language options portion of Control Panel. 예를 들어 사용자가 날짜를 다른 형식으로 표시 하거나 문화권의 기본값 이외의 다른 통화를 사용 하도록 선택할 수 있습니다.For example, the user might choose to display the date in a different format or to use a currency other than the default for the culture. 지정 된 문화권 식별자가 현재 Windows 문화권의 문화권 식별자와 일치 하는 경우이 생성자는 CultureInfo 속성에서 반환 된 인스턴스의 속성에 대 한 사용자 설정 DateTimeFormatInfo DateTimeFormatNumberFormatInfo 속성에서 반환 된 인스턴스의 속성을 비롯 하 여 이러한 재정의를 사용 하는을 만듭니다 NumberFormat .If the specified culture identifier matches the culture identifier of the current Windows culture, this constructor creates a CultureInfo that uses those overrides, including user settings for the properties of the DateTimeFormatInfo instance returned by the DateTimeFormat property, and the properties of the NumberFormatInfo instance returned by the NumberFormat property. 사용자 설정이와 연결 된 문화권과 호환 되지 않는 경우 CultureInfo (예: 선택한 달력이 중 하나가 아닌 경우 OptionalCalendars ) 메서드 결과와 속성의 값이 정의 되지 않습니다.If the user settings are incompatible with the culture associated with the CultureInfo (for example, if the selected calendar is not one of the OptionalCalendars) the results of the methods and the values of the properties are undefined.

지정 된 문화권 식별자가 현재 Windows 문화권의 식별자와 일치 하지 않는 경우이 생성자는 지정 된 CultureInfo 문화권에 대 한 기본값을 사용 하는을 만듭니다.If the specified culture identifier does not match the identifier of the current Windows culture, this constructor creates a CultureInfo that uses the default values for the specified culture.

UseUserOverride속성은 항상로 설정 됩니다 true .The UseUserOverride property is always set to true.

예를 들어 아랍어 (사우디아라비아)가 현재 Windows 문화권이 고 사용자가 회교식 달력에서 양력으로 달력을 변경 했다고 가정 합니다.For example, suppose that Arabic (Saudi Arabia) is the current Windows culture and the user has changed the calendar from Hijri to Gregorian.

유로를 사용 하는 문화권의 경우 .NET Framework 및 Windows XP에서 기본 통화를 유로화로 설정 합니다.For cultures that use the euro, the .NET Framework and Windows XP set the default currency as euro. 그러나 이전 버전의 Windows는 그렇지 않습니다.However, older versions of Windows do not. 따라서 이전 버전의 Windows 사용자가 제어판의 국가 및 언어 옵션 부분을 통해 통화 설정을 변경 하지 않은 경우 통화가 올바르지 않을 수 있습니다.Therefore, if the user of an older version of Windows has not changed the currency setting through the regional and language options portion of Control Panel, the currency might be incorrect. 통화에 대 한.NET Framework 기본 설정을 사용 하려면 애플리케이션을 사용할지는 CultureInfo 받아들이는 생성자 오버 로드를 useUserOverride 매개 변수 설정 false.To use the .NET Framework default setting for the currency, the application should use a CultureInfo constructor overload that accepts a useUserOverride parameter and set it to false.

참고

이전 버전과의 호환성을 위해 culture 0x0004 또는 0x7c04의 매개 변수를 사용 하 여 생성 된 문화권은 Name 각각 zh-cn 또는 ZH-CN-CHT의 속성을 가집니다.For backwards compatibility, a culture constructed using a culture parameter of 0x0004 or 0x7c04 will have a Name property of zh-CHS or zh-CHT, respectively. 이전 이름을 사용 해야 하는 이유가 없으면 zh-cn-Hans 또는 zh-cn-Zh-hant의 현재 표준 문화권 이름을 사용 하 여 문화권을 생성 하는 것이 좋습니다.You should instead prefer to construct the culture using the current standard culture names of zh-Hans or zh-Hant, unless you have a reason for using the older names.

호출자 참고

.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 constructor 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 exception.

추가 정보

적용 대상

CultureInfo(String)

이름에 지정된 문화권을 기반으로 CultureInfo 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the CultureInfo class based on the culture specified by name.

public:
 CultureInfo(System::String ^ name);
public CultureInfo (string name);
new System.Globalization.CultureInfo : string -> System.Globalization.CultureInfo
Public Sub New (name As String)

매개 변수

name
String

미리 정의된 CultureInfo 이름, 기존 NameCultureInfo 또는 Windows 전용 문화권 이름입니다.A predefined CultureInfo name, Name of an existing CultureInfo, or Windows-only culture name. name은(는) 대/소문자를 구분하지 않습니다.name is not case-sensitive.

예외

name가 null입니다.name is null.

name이 유효한 문화권 이름이 아닙니다.name is not a valid culture name. 자세한 내용은 호출자 참고 사항 섹션을 참조하세요.For more information, see the Notes to Callers section.

예제

다음 예제에서는 현재 문화권을 검색 합니다.The following example retrieves the current culture. 프랑스어 (프랑스) 문화권이 아닌 경우에는 생성자를 호출 CultureInfo(String) 하 여 CultureInfo 프랑스어 (프랑스) 문화권을 나타내는 개체를 인스턴스화하고 현재 스레드 문화권으로 만듭니다.If it is anything other than the French (France) culture, it calls the CultureInfo(String) constructor to instantiate a CultureInfo object that represents the French (France) culture and makes it the current thread culture. 그렇지 않으면 CultureInfo 프랑스어 (룩셈부르크) 문화권을 나타내는 개체를 인스턴스화하고 현재 문화권으로 만듭니다.Otherwise, it instantiates a CultureInfo object that represents the French (Luxembourg) culture and makes it the current culture.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      CultureInfo current = CultureInfo.CurrentCulture;
      Console.WriteLine("The current culture is {0}", current.Name);
      CultureInfo newCulture;
      if (current.Name.Equals("fr-FR"))
         newCulture = new CultureInfo("fr-LU");
      else
         newCulture = new CultureInfo("fr-FR");

      CultureInfo.CurrentCulture = newCulture;
      Console.WriteLine("The current culture is now {0}",
                        CultureInfo.CurrentCulture.Name);
   }
}
// The example displays output like the following:
//     The current culture is en-US
//     The current culture is now fr-FR
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim current As CultureInfo = CultureInfo.CurrentCulture
      Console.WriteLine("The current culture is {0}", current.Name)
      Dim newCulture As CultureInfo
      If current.Name.Equals("fr-FR") Then
         newCulture = New CultureInfo("fr-LU")
      Else   
         newCulture = new CultureInfo("fr-FR")
      End If
      
      CultureInfo.CurrentCulture = newCulture
      Console.WriteLine("The current culture is now {0}", 
                        CultureInfo.CurrentCulture.Name)   
   End Sub
End Module
' The example displays output like the following:
'     The current culture is en-US
'     The current culture is now fr-FR

설명

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.

name가 이면 String.Empty 생성자는 고정 문화권의 인스턴스를 만듭니다 .이 값은 속성의 값을 검색 하는 것과 같습니다 InvariantCulture .If name is String.Empty, the constructor creates an instance of the invariant culture; this is equivalent to retrieving the value of the InvariantCulture property.

사용자는 제어판의 국가 및 언어 옵션을 통해 Windows의 현재 문화권과 연결 된 값 중 일부를 재정의 하도록 선택할 수 있습니다.The user might choose to override some of the values associated with the current culture of Windows through the regional and language options portion of Control Panel. 예를 들어 사용자가 날짜를 다른 형식으로 표시 하거나 문화권의 기본값 이외의 다른 통화를 사용 하도록 선택할 수 있습니다.For example, the user might choose to display the date in a different format or to use a currency other than the default for the culture. 와 연결 된 문화권 식별자가 name 현재 Windows 문화권의 문화권 식별자와 일치 하는 경우이 생성자는 CultureInfo 속성에서 반환 된 인스턴스의 속성에 대 한 사용자 설정 DateTimeFormatInfo DateTimeFormatNumberFormatInfo 속성에서 반환 된 인스턴스의 속성을 비롯 하 여 이러한 재정의를 사용 하는 개체를 만듭니다 NumberFormat .If the culture identifier associated with name matches the culture identifier of the current Windows culture, this constructor creates a CultureInfo object that uses those overrides, including user settings for the properties of the DateTimeFormatInfo instance returned by the DateTimeFormat property, and the properties of the NumberFormatInfo instance returned by the NumberFormat property. 사용자 설정이와 연결 된 문화권과 호환 되지 않는 경우, CultureInfo 예를 들어 선택한 달력이 중 하나가 아닌 경우 OptionalCalendars 메서드 결과와 속성의 값이 정의 되지 않습니다.If the user settings are incompatible with the culture associated with the CultureInfo, for example, if the selected calendar is not one of the OptionalCalendars, the results of the methods and the values of the properties are undefined.

와 연결 된 문화권 식별자 name 가 현재 Windows 문화권의 문화권 식별자와 일치 하지 않는 경우이 생성자는 지정 된 CultureInfo 문화권에 대 한 기본값을 사용 하는 개체를 만듭니다.If the culture identifier associated with name does not match the culture identifier of the current Windows culture, this constructor creates a CultureInfo object that uses the default values for the specified culture.

UseUserOverride속성은 항상로 설정 됩니다 true .The UseUserOverride property is always set to true.

예를 들어 아랍어 (사우디아라비아)가 Windows의 현재 문화권이 고 사용자가 회교식에서 양력으로 달력을 변경 했다고 가정 합니다.For example, suppose that Arabic (Saudi Arabia) is the current culture of Windows and the user changed the calendar from Hijri to Gregorian.

LCID새의 속성 CultureInfo 은 지정 된 이름과 연결 된 문화권 식별자로 설정 됩니다.The LCID property of the new CultureInfo is set to the culture identifier associated with the specified name.

유로를 사용 하는 문화권의 경우 .NET Framework 및 Windows XP에서 기본 통화를 유로화로 설정 합니다.For cultures that use the euro, the .NET Framework and Windows XP set the default currency as euro. 그러나 이전 버전의 Windows에서는이 작업을 수행 하지 않습니다.However, older versions of Windows do not do this. 따라서 이전 버전의 Windows 사용자가 제어판의 국가 및 언어 옵션 부분을 통해 통화 설정을 변경 하지 않은 경우 통화가 올바르지 않을 수 있습니다.Therefore, if the user of an older version of Windows has not changed the currency setting through the regional and language options portion of Control Panel, the currency might be incorrect. 통화에 대 한.NET Framework 기본 설정을 사용 하려면 애플리케이션을 사용할지는 CultureInfo 받아들이는 생성자 오버 로드를 useUserOverride 매개 변수 설정 false.To use the .NET Framework default setting for the currency, the application should use a CultureInfo constructor overload that accepts a useUserOverride parameter and set it to false.

호출자 참고

.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 constructor 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.

추가 정보

적용 대상

CultureInfo(Int32, Boolean)

사용자가 시스템에서 선택한 문화권 설정을 사용할지 여부를 지정하는 부울과 문화권 식별자별로 지정된 문화권을 기반으로 하는 CultureInfo 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the CultureInfo class based on the culture specified by the culture identifier and on the Boolean that specifies whether to use the user-selected culture settings from the system.

public:
 CultureInfo(int culture, bool useUserOverride);
public CultureInfo (int culture, bool useUserOverride);
new System.Globalization.CultureInfo : int * bool -> System.Globalization.CultureInfo
Public Sub New (culture As Integer, useUserOverride As Boolean)

매개 변수

culture
Int32

미리 정의된 CultureInfo 식별자, 기존 LCID 개체의 CultureInfo 속성 또는 Windows 전용 문화권 식별자입니다.A predefined CultureInfo identifier, LCID property of an existing CultureInfo object, or Windows-only culture identifier.

useUserOverride
Boolean

사용자가 선택한 문화권 설정(true)을 사용할지 아니면 기본 문화권 설정(false)을 사용할지를 나타내는 부울입니다.A Boolean that denotes whether to use the user-selected culture settings (true) or the default culture settings (false).

예외

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

culture가 올바른 문화권 식별자가 아닙니다.culture is not a valid culture identifier. 자세한 내용은 호출자 참고 사항을 참조하세요.See the Notes to Callers section for more information.

설명

Windows 시스템에서 사용할 수 있는 미리 정의 된 문화권 식별자는 windows에서 지 원하는 언어/지역 이름 목록의 언어 태그 열에 나열 됩니다.Predefined culture identifiers available on Windows systems are listed in 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.

대부분의 경우 culture 매개 변수는 해당 하는 NLS (국가별 언어 지원) 로캘 식별자에 매핑됩니다.In most cases, the culture parameter is mapped to the corresponding National Language Support (NLS) locale identifier. 매개 변수의 값은 culture 새의 속성 값이 됩니다 LCID CultureInfo .The value of the culture parameter becomes the value of the LCID property of the new CultureInfo.

로캘 이름은 Lcid 보다 선호 되므로 로캘 이름 생성자를 호출 하는 것이 좋습니다 CultureInfo.CultureInfo .We recommend that you call the locale name constructor CultureInfo.CultureInfo, because locale names are preferable to LCIDs. 사용자 지정 로캘의 경우 로캘 이름이 필요 합니다.For custom locales, a locale name is required.

사용자는 제어판의 국가 및 언어 옵션을 통해 Windows의 현재 문화권과 연결 된 값 중 일부를 재정의 하도록 선택할 수 있습니다.The user might choose to override some of the values associated with the current culture of Windows through the regional and language options portion of Control Panel. 예를 들어 사용자가 날짜를 다른 형식으로 표시 하거나 문화권의 기본값 이외의 다른 통화를 사용 하도록 선택할 수 있습니다.For example, the user might choose to display the date in a different format or to use a currency other than the default for the culture.

애플리케이션은 일반적으로 허용 하지 않습니다 사용자 재정의 합니다.Applications should typically not disallow user overrides. 재정의를 허용 하지 않으면 데이터 안정성이 보장 되지 않습니다. 블로그 항목 Culture 데이터는 고정을 제외 하 고 안정적으로 고려 하지 않아야합니다 .를 참조 하세요.Note that disallowing overrides does not itself guarantee data stability; see the blog entry Culture data shouldn't be considered stable (except for Invariant).

UseUserOverride속성이로 설정 되 true 고 지정 된 문화권 식별자가 현재 Windows 문화권의 식별자와 일치 하는 경우이 생성자는 CultureInfo 속성에서 반환 된 인스턴스의 속성에 대 한 사용자 설정 DateTimeFormatInfo DateTimeFormatNumberFormatInfo 속성에서 반환 된 인스턴스의 속성을 비롯 하 여 이러한 재정의를 사용 하는을 만듭니다 NumberFormat .If the UseUserOverride property is set to true and the specified culture identifier matches the identifier of the current Windows culture, this constructor creates a CultureInfo that uses those overrides, including user settings for the properties of the DateTimeFormatInfo instance returned by the DateTimeFormat property, and the properties of the NumberFormatInfo instance returned by the NumberFormat property. 사용자 설정이와 연결 된 문화권과 호환 되지 않는 경우, CultureInfo 예를 들어 선택한 달력이 중 하나가 아닌 경우 OptionalCalendars 메서드 결과와 속성의 값이 정의 되지 않습니다.If the user settings are incompatible with the culture associated with the CultureInfo, for example, if the selected calendar is not one of the OptionalCalendars, the results of the methods and the values of the properties are undefined.

그렇지 않으면이 생성자는 CultureInfo 지정 된 문화권에 대 한 기본값을 사용 하는을 만듭니다.Otherwise, this constructor creates a CultureInfo that uses the default values for the specified culture.

매개 변수의 값은 useUserOverride 속성의 값이 됩니다 UseUserOverride .The value of the useUserOverride parameter becomes the value of the UseUserOverride property.

예를 들어 아랍어 (사우디아라비아)가 창의 현재 문화권이 고 사용자가 회교식에서 양력으로 달력을 변경 했다고 가정 합니다.For example, suppose that Arabic (Saudi Arabia) is the current culture of Windows and the user has changed the calendar from Hijri to Gregorian.

유로를 사용 하는 문화권의 경우 .NET Framework 및 Windows XP에서 기본 통화를 유로화로 설정 합니다.For cultures that use the euro, the .NET Framework and Windows XP set the default currency as euro. 그러나 이전 버전의 Windows는 그렇지 않습니다.However, older versions of Windows do not. 따라서 이전 버전의 Windows 사용자가 제어판의 국가 및 언어 옵션 부분을 통해 통화 설정을 변경 하지 않은 경우 통화가 올바르지 않을 수 있습니다.Therefore, if the user of an older version of Windows has not changed the currency setting through the regional and language options portion of Control Panel, the currency might be incorrect. 통화에 대 한.NET Framework 기본 설정을 사용 하려면 애플리케이션 설정 해야 합니다 useUserOverride 매개 변수를 false입니다.To use the .NET Framework default setting for the currency, the application should set the useUserOverride parameter to false.

참고

이전 버전과의 호환성을 위해 culture 0x0004 또는 0x7c04의 매개 변수를 사용 하 여 생성 된 문화권은 Name 각각 zh-cn 또는 ZH-CN-CHT의 속성을 가집니다.For backwards compatibility, a culture constructed using a culture parameter of 0x0004 or 0x7c04 will have a Name property of zh-CHS or zh-CHT, respectively. 이전 이름을 사용 해야 하는 이유가 없으면 zh-cn-Hans 또는 zh-cn-Zh-hant의 현재 표준 문화권 이름을 사용 하 여 문화권을 생성 하는 것이 좋습니다.You should instead prefer to construct the culture using the current standard culture names of zh-Hans or zh-Hant, unless you have a reason for using the older names.

호출자 참고

.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 constructor 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 exception.

추가 정보

적용 대상

CultureInfo(String, Boolean)

사용자가 시스템에서 선택한 문화권 설정을 사용할지 여부를 지정하는 부울과 이름별로 지정된 문화권을 기반으로 하는 CultureInfo 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the CultureInfo class based on the culture specified by name and on the Boolean that specifies whether to use the user-selected culture settings from the system.

public:
 CultureInfo(System::String ^ name, bool useUserOverride);
public CultureInfo (string name, bool useUserOverride);
new System.Globalization.CultureInfo : string * bool -> System.Globalization.CultureInfo
Public Sub New (name As String, useUserOverride As Boolean)

매개 변수

name
String

미리 정의된 CultureInfo 이름, 기존 NameCultureInfo 또는 Windows 전용 문화권 이름입니다.A predefined CultureInfo name, Name of an existing CultureInfo, or Windows-only culture name. name은(는) 대/소문자를 구분하지 않습니다.name is not case-sensitive.

useUserOverride
Boolean

사용자가 선택한 문화권 설정(true)을 사용할지 아니면 기본 문화권 설정(false)을 사용할지를 나타내는 부울입니다.A Boolean that denotes whether to use the user-selected culture settings (true) or the default culture settings (false).

예외

name가 null입니다.name is null.

name 이 유효한 문화권 이름이 아닙니다.name is not a valid culture name. 자세한 내용은 호출자 참고 사항을 참조하세요.See the Notes to Callers section for more information.

설명

미리 정의 된 문화권 이름의 목록은 Windows에서 지 원하는 언어/지역 이름 목록의 언어 태그 열을 참조 하세요.For a list of predefined culture names, 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.

name가 이면 String.Empty 생성자는 고정 문화권의 인스턴스를 만듭니다 .이 값은 속성의 값을 검색 하는 것과 같습니다 InvariantCulture .If name is String.Empty, the constructor creates an instance of the invariant culture; this is equivalent to retrieving the value of the InvariantCulture property.

사용자는 제어판의 국가 및 언어 옵션을 통해 현재 Windows 문화권과 관련 된 값 중 일부를 재정의 하도록 선택할 수 있습니다.The user might choose to override some of the values associated with the current Windows culture through the regional and language options portion of Control Panel. 예를 들어 사용자가 날짜를 다른 형식으로 표시 하거나 문화권의 기본값 이외의 다른 통화를 사용 하도록 선택할 수 있습니다.For example, the user might choose to display the date in a different format or to use a currency other than the default for the culture.

애플리케이션은 일반적으로 허용 하지 않습니다 사용자 재정의 합니다.Applications should typically not disallow user overrides. 재정의를 허용 하지 않으면 데이터 안정성이 보장 되지 않습니다. 블로그 항목 Culture 데이터는 고정을 제외 하 고 안정적으로 고려 하지 않아야합니다 .를 참조 하세요.Note that disallowing overrides does not itself guarantee data stability; see the blog entry Culture data shouldn't be considered stable (except for Invariant).

UseUserOverride속성이로 설정 되 true 고 지정 된 문화권 이름과 연결 된 문화권 식별자가 현재 Windows 문화권의 문화권 식별자와 일치 하는 경우이 생성자는 CultureInfo 속성에서 반환 된 인스턴스의 속성에 대 한 사용자 설정 DateTimeFormatInfo DateTimeFormatNumberFormatInfo 속성에서 반환 된 인스턴스의 속성을 비롯 하 여 이러한 재정의를 사용 하는을 만듭니다 NumberFormat .If the UseUserOverride property is set to true and the culture identifier associated with the specified culture name matches the culture identifier of the current Windows culture, this constructor creates a CultureInfo that uses those overrides, including user settings for the properties of the DateTimeFormatInfo instance returned by the DateTimeFormat property, and the properties of the NumberFormatInfo instance returned by the NumberFormat property. 사용자 설정이와 연결 된 문화권과 호환 되지 않는 경우, CultureInfo 예를 들어 선택한 달력이 중 하나가 아닌 경우 OptionalCalendars 메서드 결과와 속성의 값이 정의 되지 않습니다.If the user settings are incompatible with the culture associated with the CultureInfo, for example, if the selected calendar is not one of the OptionalCalendars, the results of the methods and the values of the properties are undefined.

그렇지 않으면이 생성자는 CultureInfo 지정 된 문화권에 대 한 기본값을 사용 하는을 만듭니다.Otherwise, this constructor creates a CultureInfo that uses the default values for the specified culture.

매개 변수의 값은 useUserOverride 속성의 값이 됩니다 UseUserOverride .The value of the useUserOverride parameter becomes the value of the UseUserOverride property.

예를 들어 아랍어 (사우디아라비아)가 Windows의 현재 문화권이 고 사용자가 회교식에서 양력으로 달력을 변경 했다고 가정 합니다.For example, suppose that Arabic (Saudi Arabia) is the current culture of Windows and the user changed the calendar from Hijri to Gregorian.

LCID새의 속성 CultureInfo 은 지정 된 이름과 연결 된 문화권 식별자로 설정 됩니다.The LCID property of the new CultureInfo is set to the culture identifier associated with the specified name.

유로를 사용 하는 문화권의 경우 .NET Framework 및 Windows XP에서 기본 통화를 유로화로 설정 합니다.For cultures that use the euro, the .NET Framework and Windows XP set the default currency as euro. 그러나 이전 버전의 Windows에서는이 작업을 수행 하지 않습니다.However, older versions of Windows do not do this. 따라서 이전 버전의 Windows 사용자가 제어판의 국가 및 언어 옵션 부분을 통해 통화 설정을 변경 하지 않은 경우 통화가 올바르지 않을 수 있습니다.Therefore, if the user of an older version of Windows has not changed the currency setting through the regional and language options portion of Control Panel, the currency might be incorrect. 통화에 대 한.NET Framework 기본 설정을 사용 하려면 애플리케이션 설정 해야 합니다 useUserOverride 매개 변수를 false입니다.To use the .NET Framework default setting for the currency, the application should set the useUserOverride parameter to false.

호출자 참고

.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 constructor 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.

추가 정보

적용 대상