CultureInfo 클래스

정의

네임스페이스:

System.Globalization

어셈블리:

System.Runtime.dll

Source:

CultureInfo.cs

특정 문화권(비관리 코드 개발의 경우 로캘이라고 함)에 대한 정보를 제공합니다. 이 정보에는 문화권 이름, 쓰기 시스템, 사용된 달력, 문자열의 정렬 순서, 날짜 및 숫자 형식이 포함되어 있습니다.

public ref class CultureInfo : ICloneable, IFormatProvider

public class CultureInfo : ICloneable, IFormatProvider

type CultureInfo = class
    interface ICloneable
    interface IFormatProvider

Public Class CultureInfo
Implements ICloneable, IFormatProvider

상속

Object

CultureInfo

구현

IFormatProvider ICloneable

예제

다음 예제에서는 국가별 정렬을 사용하여 스페인어(스페인)에 대한 개체를 만드는 방법과 기존 정렬을 사용하는 다른 CultureInfo 개체를 만드는 CultureInfo 방법을 보여 줍니다.

using namespace System;
using namespace System::Collections;
using namespace System::Globalization;
int main()
{
   
   // Creates and initializes the CultureInfo which uses the international sort.
   CultureInfo^ myCIintl = gcnew CultureInfo( "es-ES",false );
   
   // Creates and initializes the CultureInfo which uses the traditional sort.
   CultureInfo^ myCItrad = gcnew CultureInfo( 0x040A,false );
   
   // Displays the properties of each culture.
   Console::WriteLine( "{0,-31}{1,-47}{2,-25}", "PROPERTY", "INTERNATIONAL", "TRADITIONAL" );
   Console::WriteLine( "{0,-31}{1,-47}{2,-25}", "CompareInfo", myCIintl->CompareInfo, myCItrad->CompareInfo );
   Console::WriteLine( "{0,-31}{1,-47}{2,-25}", "DisplayName", myCIintl->DisplayName, myCItrad->DisplayName );
   Console::WriteLine( "{0,-31}{1,-47}{2,-25}", "EnglishName", myCIintl->EnglishName, myCItrad->EnglishName );
   Console::WriteLine( "{0,-31}{1,-47}{2,-25}", "IsNeutralCulture", myCIintl->IsNeutralCulture, myCItrad->IsNeutralCulture );
   Console::WriteLine( "{0,-31}{1,-47}{2,-25}", "IsReadOnly", myCIintl->IsReadOnly, myCItrad->IsReadOnly );
   Console::WriteLine( "{0,-31}{1,-47}{2,-25}", "LCID", myCIintl->LCID, myCItrad->LCID );
   Console::WriteLine( "{0,-31}{1,-47}{2,-25}", "Name", myCIintl->Name, myCItrad->Name );
   Console::WriteLine( "{0,-31}{1,-47}{2,-25}", "NativeName", myCIintl->NativeName, myCItrad->NativeName );
   Console::WriteLine( "{0,-31}{1,-47}{2,-25}", "Parent", myCIintl->Parent, myCItrad->Parent );
   Console::WriteLine( "{0,-31}{1,-47}{2,-25}", "TextInfo", myCIintl->TextInfo, myCItrad->TextInfo );
   Console::WriteLine( "{0,-31}{1,-47}{2,-25}", "ThreeLetterISOLanguageName", myCIintl->ThreeLetterISOLanguageName, myCItrad->ThreeLetterISOLanguageName );
   Console::WriteLine( "{0,-31}{1,-47}{2,-25}", "ThreeLetterWindowsLanguageName", myCIintl->ThreeLetterWindowsLanguageName, myCItrad->ThreeLetterWindowsLanguageName );
   Console::WriteLine( "{0,-31}{1,-47}{2,-25}", "TwoLetterISOLanguageName", myCIintl->TwoLetterISOLanguageName, myCItrad->TwoLetterISOLanguageName );
   Console::WriteLine();
   
   // Compare two strings using myCIintl -> 
   Console::WriteLine( "Comparing \"llegar\" and \"lugar\"" );
   Console::WriteLine( "   With myCIintl -> CompareInfo -> Compare: {0}", myCIintl->CompareInfo->Compare( "llegar", "lugar" ) );
   Console::WriteLine( "   With myCItrad -> CompareInfo -> Compare: {0}", myCItrad->CompareInfo->Compare( "llegar", "lugar" ) );
}

/*
This code produces the following output.

PROPERTY                       INTERNATIONAL                                  TRADITIONAL              
CompareInfo                    CompareInfo - es-ES                            CompareInfo - es-ES_tradnl
DisplayName                    Spanish (Spain)                                Spanish (Spain)          
EnglishName                    Spanish (Spain, International Sort)            Spanish (Spain, Traditional Sort)
IsNeutralCulture               False                                          False                    
IsReadOnly                     False                                          False                    
LCID                           3082                                           1034                     
Name                           es-ES                                          es-ES                    
NativeName                     Español (España, alfabetización internacional) Español (España, alfabetización tradicional)
Parent                         es                                             es                       
TextInfo                       TextInfo - es-ES                               TextInfo - es-ES_tradnl  
ThreeLetterISOLanguageName     spa                                            spa                      
ThreeLetterWindowsLanguageName ESN                                            ESP                      
TwoLetterISOLanguageName       es                                             es                       

Comparing "llegar" and "lugar"
   With myCIintl -> CompareInfo -> Compare: -1
   With myCItrad -> CompareInfo -> Compare: 1

*/

using System;
using System.Globalization;

public class SamplesCultureInfo
{
    public static void Main()
    {
        // Creates and initializes the CultureInfo which uses the international sort.
        CultureInfo myCIintl = new CultureInfo("es-ES", false);

        // Creates and initializes the CultureInfo which uses the traditional sort.
        CultureInfo myCItrad = new CultureInfo(0x040A, false);

        // Displays the properties of each culture.
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "PROPERTY", "INTERNATIONAL", "TRADITIONAL");
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "CompareInfo", myCIintl.CompareInfo, myCItrad.CompareInfo);
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "DisplayName", myCIintl.DisplayName, myCItrad.DisplayName);
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "EnglishName", myCIintl.EnglishName, myCItrad.EnglishName);
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "IsNeutralCulture", myCIintl.IsNeutralCulture, myCItrad.IsNeutralCulture);
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "IsReadOnly", myCIintl.IsReadOnly, myCItrad.IsReadOnly);
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "LCID", myCIintl.LCID, myCItrad.LCID);
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "Name", myCIintl.Name, myCItrad.Name);
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "NativeName", myCIintl.NativeName, myCItrad.NativeName);
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "Parent", myCIintl.Parent, myCItrad.Parent);
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "TextInfo", myCIintl.TextInfo, myCItrad.TextInfo);
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "ThreeLetterISOLanguageName", myCIintl.ThreeLetterISOLanguageName, myCItrad.ThreeLetterISOLanguageName);
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "ThreeLetterWindowsLanguageName", myCIintl.ThreeLetterWindowsLanguageName, myCItrad.ThreeLetterWindowsLanguageName);
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "TwoLetterISOLanguageName", myCIintl.TwoLetterISOLanguageName, myCItrad.TwoLetterISOLanguageName);
        Console.WriteLine();

        // Compare two strings using myCIintl.
        Console.WriteLine("Comparing \"llegar\" and \"lugar\"");
        Console.WriteLine("   With myCIintl.CompareInfo.Compare: {0}", myCIintl.CompareInfo.Compare("llegar", "lugar"));
        Console.WriteLine("   With myCItrad.CompareInfo.Compare: {0}", myCItrad.CompareInfo.Compare("llegar", "lugar"));
    }
}

/*
This code produces the following output.

PROPERTY                       INTERNATIONAL                                  TRADITIONAL
CompareInfo                    CompareInfo - es-ES                            CompareInfo - es-ES_tradnl
DisplayName                    Spanish (Spain)                                Spanish (Spain)
EnglishName                    Spanish (Spain, International Sort)            Spanish (Spain, Traditional Sort)
IsNeutralCulture               False                                          False
IsReadOnly                     False                                          False
LCID                           3082                                           1034
Name                           es-ES                                          es-ES
NativeName                     Español (España, alfabetización internacional) Español (España, alfabetización tradicional)
Parent                         es                                             es
TextInfo                       TextInfo - es-ES                               TextInfo - es-ES_tradnl
ThreeLetterISOLanguageName     spa                                            spa
ThreeLetterWindowsLanguageName ESN                                            ESP
TwoLetterISOLanguageName       es                                             es

Comparing "llegar" and "lugar"
   With myCIintl.CompareInfo.Compare: -1
   With myCItrad.CompareInfo.Compare: 1

*/

Imports System.Collections
Imports System.Globalization

Module Module1

    Public Sub Main()

        ' Creates and initializes the CultureInfo which uses the international sort.
        Dim myCIintl As New CultureInfo("es-ES", False)

        ' Creates and initializes the CultureInfo which uses the traditional sort.
        Dim myCItrad As New CultureInfo(&H40A, False)

        ' Displays the properties of each culture.
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "PROPERTY", "INTERNATIONAL", "TRADITIONAL")
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "CompareInfo", myCIintl.CompareInfo, myCItrad.CompareInfo)
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "DisplayName", myCIintl.DisplayName, myCItrad.DisplayName)
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "EnglishName", myCIintl.EnglishName, myCItrad.EnglishName)
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "IsNeutralCulture", myCIintl.IsNeutralCulture, myCItrad.IsNeutralCulture)
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "IsReadOnly", myCIintl.IsReadOnly, myCItrad.IsReadOnly)
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "LCID", myCIintl.LCID, myCItrad.LCID)
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "Name", myCIintl.Name, myCItrad.Name)
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "NativeName", myCIintl.NativeName, myCItrad.NativeName)
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "Parent", myCIintl.Parent, myCItrad.Parent)
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "TextInfo", myCIintl.TextInfo, myCItrad.TextInfo)
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "ThreeLetterISOLanguageName", myCIintl.ThreeLetterISOLanguageName, myCItrad.ThreeLetterISOLanguageName)
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "ThreeLetterWindowsLanguageName", myCIintl.ThreeLetterWindowsLanguageName, myCItrad.ThreeLetterWindowsLanguageName)
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "TwoLetterISOLanguageName", myCIintl.TwoLetterISOLanguageName, myCItrad.TwoLetterISOLanguageName)
        Console.WriteLine()

        ' Compare two strings using myCIintl.
        Console.WriteLine("Comparing ""llegar"" and ""lugar""")
        Console.WriteLine("   With myCIintl.CompareInfo.Compare: {0}", myCIintl.CompareInfo.Compare("llegar", "lugar"))
        Console.WriteLine("   With myCItrad.CompareInfo.Compare: {0}", myCItrad.CompareInfo.Compare("llegar", "lugar"))

    End Sub



'This code produces the following output.
'
'PROPERTY                       INTERNATIONAL                                  TRADITIONAL              
'CompareInfo                    CompareInfo - es-ES                            CompareInfo - es-ES_tradnl
'DisplayName                    Spanish (Spain)                                Spanish (Spain)          
'EnglishName                    Spanish (Spain, International Sort)            Spanish (Spain, Traditional Sort)
'IsNeutralCulture               False                                          False                    
'IsReadOnly                     False                                          False                    
'LCID                           3082                                           1034                     
'Name                           es-ES                                          es-ES                    
'NativeName                     Español (España, alfabetización internacional) Español (España, alfabetización tradicional)
'Parent                         es                                             es                       
'TextInfo                       TextInfo - es-ES                               TextInfo - es-ES_tradnl  
'ThreeLetterISOLanguageName     spa                                            spa                      
'ThreeLetterWindowsLanguageName ESN                                            ESP                      
'TwoLetterISOLanguageName       es                                             es                       
'
'Comparing "llegar" and "lugar"
'   With myCIintl.CompareInfo.Compare: -1
'   With myCItrad.CompareInfo.Compare: 1

End Module

설명

이 API에 대한 자세한 내용은 CultureInfo에 대한 추가 API 설명을 참조하세요.

생성자

CultureInfo(Int32)	문화권 식별자별로 지정된 문화권을 기반으로 하는 CultureInfo 클래스의 새 인스턴스를 초기화합니다.
CultureInfo(Int32, Boolean)	문화권 식별자가 지정한 문화권 및 Windows에서 사용자가 선택한 문화권 설정을 사용할지 여부를 지정하는 값에 따라 클래스의 새 CultureInfo instance 초기화합니다.
CultureInfo(String)	이름에 지정된 문화권을 기반으로 CultureInfo 클래스의 새 인스턴스를 초기화합니다.
CultureInfo(String, Boolean)	이름으로 지정된 문화권과 Windows에서 사용자가 선택한 문화권 설정을 사용할지 여부를 지정하는 값에 따라 클래스의 새 CultureInfo instance 초기화합니다.

속성

Calendar	문화권에서 사용하는 기본 달력을 가져옵니다.
CompareInfo	문화권에 대한 문자열을 비교하는 방법을 정의하는 CompareInfo를 가져옵니다.
CultureTypes	현재 CultureInfo 개체와 관련된 문화권 형식을 가져옵니다.
CurrentCulture	현재 스레드 및 작업 기반 비동기 작업에서 사용하는 문화권을 나타내는 개체를 가져오거나 설정합니다 CultureInfo .
CurrentUICulture	리소스 관리자가 런타임에 문화권 관련 리소스를 찾기 위해 사용하는 현재 사용자 인터페이스를 나타내는 CultureInfo 개체를 가져오거나 설정합니다.
DateTimeFormat	날짜와 시간 표시를 위한 문화권 형식을 정의하는 DateTimeFormatInfo 를 가져오거나 설정합니다.
DefaultThreadCurrentCulture	현재 애플리케이션 도메인의 스레드에 대한 기본 문화권을 가져오거나 설정합니다.
DefaultThreadCurrentUICulture	현재 애플리케이션 도메인의 스레드에 대한 기본 UI 문화권을 가져오거나 설정합니다.
DisplayName	전체 지역화된 문화 이름을 가져옵니다.
EnglishName	문화권 이름을 languagefull[country/regionfull](영어) 형식으로 가져옵니다.
IetfLanguageTag	더 이상 사용되지 않습니다. RFC 4646 표준 식별 언어를 가져옵니다.
InstalledUICulture	운영 체제에 설치된 문화권을 나타내는 CultureInfo를 가져옵니다.
InvariantCulture	문화권 독립(고정)적인 CultureInfo 개체를 가져옵니다.
IsNeutralCulture	현재 CultureInfo가 중립 문화권을 표시하는지 여부를 나타내는 값을 가져옵니다.
IsReadOnly	현재 CultureInfo가 읽기 전용인지 여부를 나타내는 값을 가져옵니다.
KeyboardLayoutId	활성 입력 로캘 식별자를 가져옵니다.
LCID	현재 CultureInfo에 대한 문화권 식별자를 가져옵니다.
Name	languagecode2-country/regioncode2 형식의 문화권 이름을 가져옵니다.
NativeName	문화권에서 표시하도록 설정된 문화권 이름(언어, 국가/지역 및 선택적 스크립트로 구성됨)을 가져옵니다.
NumberFormat	숫자, 통화 및 백분율 표시를 위한 문화권 형식을 정의하는 NumberFormatInfo를 가져오거나 설정합니다.
OptionalCalendars	문화권에서 사용할 수 있는 달력 목록을 가져옵니다.
Parent	현재 CultureInfo의 부모 문화권을 나타내는 CultureInfo를 가져옵니다.
TextInfo	문화권과 관련된 쓰기 시스템을 정의하는 TextInfo를 가져옵니다.
ThreeLetterISOLanguageName	현재 CultureInfo 언어를 나타내는 세 문자로 된 ISO 639-2 코드를 가져옵니다.
ThreeLetterWindowsLanguageName	Windows API에 정의된 해당 언어를 나타내는 세 문자로 된 코드를 가져옵니다.
TwoLetterISOLanguageName	현재 CultureInfo의 언어에 대한 ISO 639-1 2자 또는 ISO 639-3 3자 코드를 가져옵니다.
UseUserOverride	현재 CultureInfo 개체에서 사용자가 선택한 문화권 설정을 사용하는지 여부를 나타내는 값을 가져옵니다.

메서드

ClearCachedData()	캐시된 문화권 관련 정보를 새로 고칩니다.
Clone()	현재 CultureInfo의 복사본을 만듭니다.
CreateSpecificCulture(String)	지정된 이름과 관련된 특정 문화권을 나타내는 CultureInfo을(를) 만듭니다.
Equals(Object)	지정된 개체가 현재 CultureInfo와 같은 문화권인지 여부를 확인합니다.
GetConsoleFallbackUICulture()	기본 그래픽 사용자 인터페이스 문화권이 적합하지 않은 경우 콘솔 애플리케이션에 적합한 대체 사용자 인터페이스 문화권을 가져옵니다.
GetCultureInfo(Int32)	지정된 문화권 식별자를 사용하여 문화권의 캐시된 읽기 전용 인스턴스를 검색합니다.
GetCultureInfo(String)	지정된 문화권 이름을 사용하여 문화권의 캐시된 읽기 전용 인스턴스를 검색합니다.
GetCultureInfo(String, Boolean)	문화권의 캐시된 읽기 전용 인스턴스를 검색합니다.
GetCultureInfo(String, String)	문화권의 캐시된 읽기 전용 인스턴스를 검색합니다. 매개 변수는 다른 문화권이 지정하는 TextInfo 및 CompareInfo 개체를 사용하여 초기화되는 문화권을 지정합니다.
GetCultureInfoByIetfLanguageTag(String)	더 이상 사용되지 않습니다. 지정된 RFC 4646 언어 태그에 의해 언어적 특성이 식별되는 읽기 전용 CultureInfo 개체를 검색합니다.
GetCultures(CultureTypes)	지정된 CultureTypes 매개 변수에 의해 필터링된 지원 문화권 목록을 가져옵니다.
GetFormat(Type)	지정된 형식의 서식을 지정하는 방법을 정의하는 개체를 가져옵니다.
GetHashCode()	해시 알고리즘과 해시 테이블 같은 데이터 구조에 적합한 현재 CultureInfo에 대한 해시 함수의 역할을 합니다.
GetType()	현재 인스턴스의 Type을 가져옵니다. (다음에서 상속됨 Object)
MemberwiseClone()	현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object)
ReadOnly(CultureInfo)	지정된 CultureInfo 개체의 읽기 전용 래퍼를 반환합니다.
ToString()	languagecode2-country/regioncode2 형식으로 현재 CultureInfo의 이름을 포함하는 문자열을 반환합니다.

추가 정보

• CultureAndRegionInfoBuilder
• RegionInfo