CultureAndRegionInfoBuilder 클래스
이 문서는 기계로 번역한 것입니다. 원본 텍스트를 보려면 포인터를 문서의 문장 위로 올리십시오. 추가 정보
번역
원본

CultureAndRegionInfoBuilder 클래스

 

다른 문화권 및 국가/지역을 기반으로 또는 새로 사용자 지정 문화권을 정의합니다.사용자 지정 문화권을 컴퓨터에 설치하면 이후 해당 컴퓨터에서 실행되는 응용 프로그램에서 이 문화권을 사용할 수 있습니다.이 클래스는 상속될 수 없습니다.

네임스페이스:   System.Globalization
어셈블리:  sysglobl.dll의 sysglobl

System.Object
System.Globalization.CultureAndRegionInfoBuilder

[ComVisibleAttribute(false)]
public sealed class CultureAndRegionInfoBuilder

이름설명
System_CAPS_pubmethodCultureAndRegionInfoBuilder(String, CultureAndRegionModifiers)

CultureAndRegionInfoBuilder 클래스의 새 인스턴스를 초기화합니다.

이름설명
System_CAPS_pubpropertyAvailableCalendars

CultureAndRegionInfoBuilder 개체에서 지원하는 달력의 배열을 가져오거나 설정합니다.

System_CAPS_pubpropertyCompareInfo

문화권에 대한 문자열을 비교하는 방법을 정의하는 CompareInfo 개체를 가져오거나 설정합니다.

System_CAPS_pubpropertyConsoleFallbackUICulture

기본 그래픽 사용자 인터페이스 문화권이 적합하지 않은 경우 콘솔 응용 프로그램에 적합한 대체 사용자 인터페이스 문화권을 가져오거나 설정합니다.

System_CAPS_pubpropertyCultureEnglishName

영어로 된 문화권 이름을 가져오거나 설정합니다.

System_CAPS_pubpropertyCultureName

만들 문화권의 이름을 가져옵니다.

System_CAPS_pubpropertyCultureNativeName

문화권 이름을 해당 문화권에서 표시하도록 설정된 서식 및 언어로 가져오거나 설정합니다.

System_CAPS_pubpropertyCultureTypes

현재 CultureAndRegionInfoBuilder 개체가 나타내는 문화권을 설명하는 CultureTypes 값을 가져옵니다.

System_CAPS_pubpropertyCurrencyEnglishName

현재 CultureAndRegionInfoBuilder 개체가 나타내는 국가/지역에서 사용되는 통화의 이름을 영어로 가져오거나 설정합니다.

System_CAPS_pubpropertyCurrencyNativeName

현재 CultureAndRegionInfoBuilder 개체가 나타내는 국가/지역에서 사용되는 통화의 네이티브 이름을 가져오거나 설정합니다.

System_CAPS_pubpropertyGeoId

지역, 국가, 도시 또는 위치에 대한 고유 식별 번호를 가져오거나 설정합니다.

System_CAPS_pubpropertyGregorianDateTimeFormat

양력으로 날짜 및 시간 형식을 정의하는 DateTimeFormatInfo 개체를 가져오거나 설정합니다.

System_CAPS_pubpropertyIetfLanguageTag

RFC 4646 표준, "Tags for the Identification of Languages"에 맞는 형식의 문화권 이름을 가져오거나 설정합니다.

System_CAPS_pubpropertyIsMetric

해당 국가/지역의 측정 단위가 미터법인지 여부를 나타내는 값을 가져오거나 설정합니다.

System_CAPS_pubpropertyISOCurrencySymbol

해당 국가/지역과 관련된 세 문자로 된 ISO 4217 통화 기호를 가져오거나 설정합니다.

System_CAPS_pubpropertyIsRightToLeft

현재 CultureAndRegionInfoBuilder 개체와 연관된 쓰기 시스템의 기본 텍스트 줄 방향을 가져오거나 설정합니다.

System_CAPS_pubpropertyKeyboardLayoutId

활성 입력 로캘 식별자를 가져오거나 설정합니다.

System_CAPS_pubpropertyLCID

현재 CultureAndRegionInfoBuilder 개체에 대한 문화권 식별자를 가져옵니다.

System_CAPS_pubpropertyNumberFormat

숫자, 통화 및 백분율 표시를 위한 문화권 형식을 정의하는 NumberFormatInfo 개체를 가져오거나 설정합니다.

System_CAPS_pubpropertyParent

현재 사용자 지정 문화권의 부모 문화권을 나타내는 CultureInfo 개체를 가져오거나 설정합니다.

System_CAPS_pubpropertyRegionEnglishName

해당 국가/지역의 전체 이름을 영어로 가져오거나 설정합니다.

System_CAPS_pubpropertyRegionName

현재 CultureAndRegionInfoBuilder 개체에 대한 국가/지역의 이름을 가져옵니다.

System_CAPS_pubpropertyRegionNativeName

이 사용자 지정 문화권에서 사용하는 국가/지역의 전체 이름을 가져오거나 설정합니다.

System_CAPS_pubpropertyTextInfo

이 사용자 지정 문화권과 연관된 쓰기 시스템을 정의하는 TextInfo 개체를 가져오거나 설정합니다.

System_CAPS_pubpropertyThreeLetterISOLanguageName

이 사용자 지정 문화권의 언어를 나타내는 세 문자로 된 ISO 639-2 코드를 가져오거나 설정합니다.

System_CAPS_pubpropertyThreeLetterISORegionName

해당 국가/지역에 대해 ISO 3166에 정의되어 있는 세 문자로 된 코드를 가져오거나 설정합니다.

System_CAPS_pubpropertyThreeLetterWindowsLanguageName

Windows API에 정의된 해당 언어를 나타내는 세 문자로 된 코드를 가져오거나 설정합니다.

System_CAPS_pubpropertyThreeLetterWindowsRegionName

현재 사용자 지정 문화권이 나타내는 국가/지역에 대해 Windows에서 할당한 세 문자로 된 코드를 가져오거나 설정합니다.

System_CAPS_pubpropertyTwoLetterISOLanguageName

현재 CultureInfo 개체의 언어를 나타내는 두 문자로 된 ISO 639-1 코드를 가져오거나 설정합니다.

System_CAPS_pubpropertyTwoLetterISORegionName

해당 국가/지역에 대해 ISO 3166에 정의되어 있는 두 문자로 된 코드를 가져오거나 설정합니다.

이름설명
System_CAPS_pubmethodSystem_CAPS_staticCreateFromLdml(String)

CultureAndRegionInfoBuilder 개체의 표현이 들어 있는 지정된 XML 파일에서 해당 개체를 다시 구성합니다.

System_CAPS_pubmethodEquals(Object)

지정한 개체가 현재 개체와 같은지 여부를 확인합니다. (Object에서 상속됨.)

System_CAPS_pubmethodGetHashCode()

기본 해시 함수로 작동합니다. (Object에서 상속됨.)

System_CAPS_pubmethodGetType()

현재 인스턴스의 Type을 가져옵니다.(Object에서 상속됨.)

System_CAPS_pubmethodLoadDataFromCultureInfo(CultureInfo)

현재 CultureAndRegionInfoBuilder 개체의 속성을 지정된 CultureInfo 개체의 해당 속성으로 설정합니다.

System_CAPS_pubmethodLoadDataFromRegionInfo(RegionInfo)

현재 CultureAndRegionInfoBuilder 개체의 속성을 지정된 RegionInfo 개체의 해당 속성으로 설정합니다.

System_CAPS_pubmethodRegister()

현재 CultureAndRegionInfoBuilder 개체를 로컬 컴퓨터의 사용자 지정 문화권으로 유지하고 응용 프로그램에서 해당 문화권을 사용할 수 있도록 합니다.관리 권한이 필요합니다.

System_CAPS_pubmethodSave(String)

현재 CultureAndRegionInfoBuilder 개체의 XML 표현을 지정된 파일에 씁니다.

System_CAPS_pubmethodToString()

현재 개체를 나타내는 문자열을 반환합니다.(Object에서 상속됨.)

System_CAPS_pubmethodSystem_CAPS_staticUnregister(String)

사용자 지정 문화권을 로컬 컴퓨터에서 삭제합니다.

CultureInfo 관련 된 언어, 보조 언어, 국가/지역, 달력 및 문화권 규칙 등의 문화권 관련 정보를 보유 하는 클래스입니다.또한이 클래스의 문화권별 인스턴스 제공는 DateTimeFormatInfo, NumberFormatInfo, CompareInfo, 및 TextInfo 클래스는 대/소문자 구분, 서식 지정 및 날짜와 숫자를 구문 분석 및 문자열 비교와 같은 문화권 관련 작업에 필요 합니다.

기본적으로.NET Framework 지원 CultureInfo 문화권의 미리 정의 된 집합을 나타내는 개체입니다.목록이 이러한 culture에 대 한 참조는 National Language Support (NLS) API Reference Go Global 개발자 센터에 있습니다. CultureAndRegionInfoBuilder 클래스를 사용 하면 완전히 새로운 되었거나 미리 정의 된 문화권을 재정의 하는 사용자 지정 culture를 만들 수 있습니다.사용자 지정 culture는 설치 되어 있고 특정 컴퓨터에 등록, 됩니다 구별할 미리 정의 된 CultureInfo 개체 및 인스턴스화할 하 고 사용할 수 해당 개체와 마찬가지로 합니다.

System_CAPS_important중요

이때는 CultureAndRegionInfoBuilder sysglobl.dll 이라는 어셈블리에서 발견 되는 클래스입니다.이 형식을 사용 하는 코드를 성공적으로 컴파일 sysglobl.dll에 대 한 참조를 추가 하면이 필요 합니다.

사용자 지정 culture는 컴퓨터에만 해당 컴퓨터에 대 한 관리 권한이 있는 사용자가 등록할 수 있습니다.따라서 앱 일반적으로 수행 하지 만들고 사용자 지정 culture를 설치 합니다.대신 사용할 수는 CultureAndRegionInfoBuilder 관리자 만들기, 설치 및 사용자 지정 culture를 등록 하는데 사용할 수 있는 특수 한 용도의 도구를 만드는 클래스입니다.사용자 지정 culture를 컴퓨터에 등록 후 사용할 수는 CultureInfo 클래스의 인스턴스를 만드는 사용자 지정 culture는 미리 정의 된 문화권에 대 한 것 처럼 응용 프로그램에서.

사용자 지정 culture에 대해 생성 된 날짜 및 시간 문자열을 구문 분석 하는 경우에 사용 해야는 DateTime.ParseExact 또는 DateTime.TryParseExact 메서드 대신는 DateTime.Parse 또는 DateTime.TryParse 메서드를 구문 분석 작업이 성공할 확률이 높아집니다.사용자 지정 culture에 대 한 날짜 및 시간 문자열은 복잡 하 고 구문 분석 하기 어려울 수 있습니다. ParseTryParse 메서드 중 일부는 실패할 수 있습니다, 여러 암시적 구문 분석 패턴을 사용 하 여 문자열을 구문 분석 하려고 합니다. TryParseExact 메서드를 성공할 가능성이 높은 하나 이상의 정확한 구문 분석 패턴 명시적으로 지정 하도록 응용 프로그램을 반면 필요 합니다.

사용 하면는 CultureAndRegionInfoBuilder 클래스를 정의 하 고 사용자 지정 culture 이름을 지정 합니다.사용자 지정 culture는 완전히 새로운 culture, (즉, 추가 문화권), 기존 문화권에 기반 하는 새로운 문화 또는 기존.NET Framework 문화권을 대체 하는 문화권 될 수 있습니다.각 경우에는 기본 단계는 동일합니다.

  1. 인스턴스화하는 CultureAndRegionInfoBuilder 개체를 호출 하 여 해당 CultureAndRegionInfoBuilder(String, CultureAndRegionModifiers) 생성자입니다.기존 문화권의 이름을 바꾸려면 해당 문화권의 이름을 전달 하 고 CultureAndRegionModifiers.Replacement 생성자에 게 열거형 값입니다.새로운 문화 또는 추가 문화권을 만들려면 고유 문화권 이름 및 중 하나를 전달 된 CultureAndRegionModifiers.Neutral 또는 CultureAndRegionModifiers.None 열거형 값입니다.

    System_CAPS_note참고

    사용 하는 경우는 CultureAndRegionModifiers.Replacement 를 인스턴스화하는 데 열거형 값은 CultureAndRegionInfoBuilder 개체는 CultureAndRegionInfoBuilder 개체의 속성의 값으로 자동으로 채워지는 CultureInfo 바꿀 개체입니다.

  2. 새로운 또는 보충 culture를 만드는 경우

    • 채우기는 CultureAndRegionInfoBuilder 호출 하 여 개체의 속성은 LoadDataFromCultureInfo 메서드와 전달은 CultureInfo 개체 속성 값을 가진 새 개체와 비슷합니다.

    • 채우기는 CultureAndRegionInfoBuilder 호출 하 여 개체의 국가별 속성은 LoadDataFromRegionInfo 메서드에 전달 하는 RegionInfo 사용자의 사용자 지정 culture의 영역을 나타내는 개체입니다.

  3. 속성을 수정 된 CultureAndRegionInfoBuilder 필요에 따라 개체입니다.

  4. 사용자 지정 culture는 별도 루틴에 등록 하려는 경우에 호출 된 Save 메서드.이 로드 하 고 사용자 지정 culture 별도 설치 루틴에 등록할 수 있는 XML 파일을 생성 합니다.

문화권을 야기 하는, 호출 응용 프로그램에서 분리 된 사용자 지정 culture에 대 한 등록 응용 프로그램을 개발 하는 경우는 CreateFromLdml 메서드는 사용자 지정 문화권의 정의 포함 하는 XML 파일을 로드 하 고 인스턴스화하는 CultureAndRegionInfoBuilder 개체.등록을 처리 하려면 호출의 Register 메서드.성공 하려면 등록, 사용자 지정 culture를 등록 하는 응용 프로그램에서 실행 되어야 합니다 관리자 권한으로 대상 시스템. 그렇지 않은 경우에 대 한 호출이 Register throw 한 UnauthorizedAccessException 예외입니다.

System_CAPS_warning경고

Culture 데이터 시스템 간에 다를 수 있습니다.사용 하는 경우는 CultureAndRegionInfoBuilder 은 여러 시스템 및에서 균일 하는 사용자 지정 culture를 만들 클래스에서 기존 데이터를 로드 하 여 사용자의 사용자 지정 culture 만드는 CultureInfoRegionInfo 개체 및 사용자 지정, 서로 다른 두 유틸리티를 개발 해야 합니다.첫번째는 사용자 지정 culture를 만들고 XML 파일에 저장 합니다.두번째 용도 CreateFromLdml 메서드를 XML 파일에서 사용자 지정 culture를 로드 하 고 대상 컴퓨터에 등록 합니다.

등록 프로세스는 다음과 같은 작업을 수행합니다.

  • 만듭니다는 합니다.이 파일에 정의 된 정보를 포함 하는 CultureAndRegionInfoBuilder 개체입니다.

  • 저장소는 합니다.nlp %windir%\Globalization 시스템 디렉터리에는 대상 컴퓨터에서 파일입니다.그러면 사용자 지정 culture 설정을 세션 간에 유지 됩니다.(의 CultureAndRegionInfoBuilder 메서드 하려면 관리자 권한이 필요 하기 때문에.이 파일 시스템 디렉터리에 저장 됩니다.)

  • 준비 다음에 내부 캐시 하는 대신 %windir%\Globalization 시스템 디렉터리를 검색 하려면.NET Framework는 새 사용자의 사용자 지정 culture를 만들기 위한 요청을 합니다.

사용자 지정 culture이 성공적으로 등록 하는 경우.NET Framework에 미리 정의 된 문화권 구분 되지 않습니다.에 대 한 호출 될 때까지 사용자 지정 culture를 사용할 수는 CultureAndRegionInfoBuilder 메서드 제거는 합니다.로컬 컴퓨터에서 nlp 파일입니다.

다음 방법 중 하나에서 사용자 지정 culture의 인스턴스를 만들 수 있습니다.

또한 배열 CultureInfo 에서 반환 되는 개체는 CultureInfo.GetCultures 메서드에 사용자 지정 culture를 포함 합니다.

다음 예제에서는 미국에서 러시아어 언어를 나타내는 사용자 지정 ru (미국) 문화권을 정의 합니다.이 예제에서는 러시아어 (러시아)에서 설정을 로드 하 여 사용자 지정 culture 정의 CultureInfo 개체 및 미국 RegionInfo 개체를 다양 한을 설정 하는 다음 CultureAndRegionInfoBuilder 속성입니다.이 예제에서는 사용자 지정 culture를 등록 하 고 그런 다음 인스턴스화하 하 고이 현재 스레드 문화권을 쉽게 만듭니다.

using System;
using System.Globalization;
using System.Threading;

public class Example
{
   public static void Main()
   {
      // Create a custom culture for ru-US.
      CultureAndRegionInfoBuilder car1 = new CultureAndRegionInfoBuilder("ru-US", 
                                             CultureAndRegionModifiers.None);
      car1.LoadDataFromCultureInfo(CultureInfo.CreateSpecificCulture("ru-RU"));
      car1.LoadDataFromRegionInfo(new RegionInfo("en-US"));

      car1.CultureEnglishName = "Russian (United States)";
      car1.CultureNativeName = "русский (США)";
      car1.CurrencyNativeName = "Доллар (США)";
      car1.RegionNativeName = "США";

      // Register the culture.
      try {
         car1.Register();
      }    
      catch (InvalidOperationException) {
         // Swallow the exception: the culture already is registered.
      }

      // Use the custom culture.
      CultureInfo ci = CultureInfo.CreateSpecificCulture("ru-US");
      Thread.CurrentThread.CurrentCulture = ci;
      Console.WriteLine("Current Culture: {0}", 
                        Thread.CurrentThread.CurrentCulture.Name);
      Console.WriteLine("Writing System: {0}", 
                        Thread.CurrentThread.CurrentCulture.TextInfo);
   }
}
// The example displays the following output:
//     Current Culture: ru-US
//     Writing System: TextInfo - ru-US

.NET Framework
2.0 이후에 사용 가능

이 형식의 모든 public static (Visual Basic의 경우 Shared) 멤버는 스레드로부터 안전합니다. 인터페이스 멤버는 스레드로부터 안전하지 않습니다.

맨 위로 이동
표시:
© 2016 Microsoft