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 매개 변수의 값은 새 CultureInfoLCID 속성 값이 됩니다.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 문화권의 문화권 식별자와 일치 하는 경우이 생성자는에서 반환 된 DateTimeFormatInfo 인스턴스의 속성에 대 한 사용자 설정을 포함 하 여 이러한 재정의를 사용 하는 CultureInfo를 만듭니다 DateTimeFormat 속성과 NumberFormat 속성에 의해 반환 되는 NumberFormatInfo 인스턴스의 속성입니다.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.

참고

이전 버전과의 호환성을 위해 0x0004 또는 0x7c04의 culture 매개 변수를 사용 하 여 생성 된 문화권에는 각각 zh-cn 또는 zh-cn-CHT의 Name 속성이 있습니다.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와 이전 버전은 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 constructor 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 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 문화권의 문화권 식별자와 일치 하는 경우이 생성자는 DateTimeFormatInfo 인스턴스의 속성에 대 한 사용자 설정을 포함 하 여 이러한 재정의를 사용 하는 CultureInfo 개체를 만듭니다. DateTimeFormat 속성에서 반환 되 고 NumberFormat 속성이 반환 하는 NumberFormatInfo 인스턴스의 속성을 반환 합니다.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.

CultureInfoLCID 속성은 지정 된 이름과 연결 된 문화권 식별자로 설정 됩니다.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와 이전 버전은 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 constructor 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.

추가 정보

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 매개 변수의 값은 새 CultureInfoLCID 속성 값이 됩니다.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 DateTimeFormat 속성에서 반환 된 인스턴스와 NumberFormat 속성이 반환 하는 NumberFormatInfo 인스턴스의 속성입니다.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.

참고

이전 버전과의 호환성을 위해 0x0004 또는 0x7c04의 culture 매개 변수를 사용 하 여 생성 된 문화권에는 각각 zh-cn 또는 zh-cn-CHT의 Name 속성이 있습니다.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와 이전 버전은 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 constructor 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 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을 만듭니다. DateTimeFormat 속성에서 반환 하는 DateTimeFormatInfo 인스턴스의 속성 및 NumberFormat 속성에서 반환 되는 NumberFormatInfo 인스턴스의 속성에 대 한 설정입니다.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.

CultureInfoLCID 속성은 지정 된 이름과 연결 된 문화권 식별자로 설정 됩니다.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와 이전 버전은 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 constructor 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.

추가 정보

적용 대상