RegionInfo RegionInfo RegionInfo RegionInfo Class

정의

해당 국가/지역에 대한 정보를 포함합니다.Contains information about the country/region.

public ref class RegionInfo
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public class RegionInfo
type RegionInfo = class
Public Class RegionInfo
상속
RegionInfoRegionInfoRegionInfoRegionInfo
특성

예제

다음 예제에서는의 여러 멤버를 RegionInfo 클래스입니다.The following example demonstrates several members of the RegionInfo class.

using namespace System;
using namespace System::Globalization;
int main()
{
   
   // Displays the property values of the RegionInfo for "US".
   RegionInfo^ myRI1 = gcnew RegionInfo( "US" );
   Console::WriteLine( "   Name:                         {0}", myRI1->Name );
   Console::WriteLine( "   DisplayName:                  {0}", myRI1->DisplayName );
   Console::WriteLine( "   EnglishName:                  {0}", myRI1->EnglishName );
   Console::WriteLine( "   IsMetric:                     {0}", myRI1->IsMetric );
   Console::WriteLine( "   ThreeLetterISORegionName:     {0}", myRI1->ThreeLetterISORegionName );
   Console::WriteLine( "   ThreeLetterWindowsRegionName: {0}", myRI1->ThreeLetterWindowsRegionName );
   Console::WriteLine( "   TwoLetterISORegionName:       {0}", myRI1->TwoLetterISORegionName );
   Console::WriteLine( "   CurrencySymbol:               {0}", myRI1->CurrencySymbol );
   Console::WriteLine( "   ISOCurrencySymbol:            {0}", myRI1->ISOCurrencySymbol );
   Console::WriteLine();
   
   // Compares the RegionInfo above with another RegionInfo created using CultureInfo.
   RegionInfo^ myRI2 = gcnew RegionInfo( (gcnew CultureInfo( "en-US",false ))->LCID );
   if ( myRI1->Equals( myRI2 ) )
      Console::WriteLine( "The two RegionInfo instances are equal." );
   else
      Console::WriteLine( "The two RegionInfo instances are NOT equal." );
}

/*
This code produces the following output.

   Name:                         US
   DisplayName:                  United States
   EnglishName:                  United States
   IsMetric:                     False
   ThreeLetterISORegionName:     USA
   ThreeLetterWindowsRegionName: USA
   TwoLetterISORegionName:       US
   CurrencySymbol:               $
   ISOCurrencySymbol:            USD

The two RegionInfo instances are equal.

*/
using System;
using System.Globalization;

public class SamplesRegionInfo  {

   public static void Main()  {

      // Displays the property values of the RegionInfo for "US".
      RegionInfo myRI1 = new RegionInfo( "US" );
      Console.WriteLine( "   Name:                         {0}", myRI1.Name );
      Console.WriteLine( "   DisplayName:                  {0}", myRI1.DisplayName );
      Console.WriteLine( "   EnglishName:                  {0}", myRI1.EnglishName );
      Console.WriteLine( "   IsMetric:                     {0}", myRI1.IsMetric );
      Console.WriteLine( "   ThreeLetterISORegionName:     {0}", myRI1.ThreeLetterISORegionName );
      Console.WriteLine( "   ThreeLetterWindowsRegionName: {0}", myRI1.ThreeLetterWindowsRegionName );
      Console.WriteLine( "   TwoLetterISORegionName:       {0}", myRI1.TwoLetterISORegionName );
      Console.WriteLine( "   CurrencySymbol:               {0}", myRI1.CurrencySymbol );
      Console.WriteLine( "   ISOCurrencySymbol:            {0}", myRI1.ISOCurrencySymbol );
      Console.WriteLine();

      // Compares the RegionInfo above with another RegionInfo created using CultureInfo.
      RegionInfo myRI2 = new RegionInfo( new CultureInfo("en-US",false).LCID );
      if ( myRI1.Equals( myRI2 ) )
         Console.WriteLine( "The two RegionInfo instances are equal." );
      else
         Console.WriteLine( "The two RegionInfo instances are NOT equal." );

   }

}

/*
This code produces the following output.

   Name:                         US
   DisplayName:                  United States
   EnglishName:                  United States
   IsMetric:                     False
   ThreeLetterISORegionName:     USA
   ThreeLetterWindowsRegionName: USA
   TwoLetterISORegionName:       US
   CurrencySymbol:               $
   ISOCurrencySymbol:            USD

The two RegionInfo instances are equal.

*/
Imports System
Imports System.Globalization


Public Class SamplesRegionInfo   

   Public Shared Sub Main()

      ' Displays the property values of the RegionInfo for "US".
      Dim myRI1 As New RegionInfo("US")
      Console.WriteLine("   Name:                         {0}", myRI1.Name)
      Console.WriteLine("   DisplayName:                  {0}", myRI1.DisplayName)
      Console.WriteLine("   EnglishName:                  {0}", myRI1.EnglishName)
      Console.WriteLine("   IsMetric:                     {0}", myRI1.IsMetric)
      Console.WriteLine("   ThreeLetterISORegionName:     {0}", myRI1.ThreeLetterISORegionName)
      Console.WriteLine("   ThreeLetterWindowsRegionName: {0}", myRI1.ThreeLetterWindowsRegionName)
      Console.WriteLine("   TwoLetterISORegionName:       {0}", myRI1.TwoLetterISORegionName)
      Console.WriteLine("   CurrencySymbol:               {0}", myRI1.CurrencySymbol)
      Console.WriteLine("   ISOCurrencySymbol:            {0}", myRI1.ISOCurrencySymbol)
      Console.WriteLine()

      ' Compares the RegionInfo above with another RegionInfo created using CultureInfo.
      Dim myRI2 As New RegionInfo(New CultureInfo("en-US", False).LCID)
      If myRI1.Equals(myRI2) Then
         Console.WriteLine("The two RegionInfo instances are equal.")
      Else
         Console.WriteLine("The two RegionInfo instances are NOT equal.")
      End If 

   End Sub 'Main

End Class 'SamplesRegionInfo 


'This code produces the following output.

'

'   Name:                         US

'   DisplayName:                  United States

'   EnglishName:                  United States

'   IsMetric:                     False

'   ThreeLetterISORegionName:     USA

'   ThreeLetterWindowsRegionName: USA

'   TwoLetterISORegionName:       US

'   CurrencySymbol:               $

'   ISOCurrencySymbol:            USD

'

'The two RegionInfo instances are equal.


설명

와 달리 합니다 CultureInfo 클래스는 RegionInfo 클래스 사용자 기본 설정을 나타내지 않으며 사용자의 언어 또는 문화권에 의존 하지 않습니다.Unlike the CultureInfo class, the RegionInfo class does not represent user preferences and does not depend on the user's language or culture.

RegionInfo 개체에 연결 된 이름Names Associated with a RegionInfo Object

이름을 RegionInfo 개체가 국가/지역의 ISO 3166에 정의 되어 있는 두 문자로 된 코드 중 하나입니다.The name of a RegionInfo object is one of the two-letter codes defined in ISO 3166 for country/region. 대/소문자는 중요 하지 않습니다.Case is not significant. 합니다 Name, TwoLetterISORegionName, 및 ThreeLetterISORegionName 속성 대문자를 적절 한 코드를 반환 합니다.The Name, TwoLetterISORegionName, and ThreeLetterISORegionName properties return the appropriate codes in uppercase. 현재 목록은 RegionInfo 이름을 참조 영어 국가 이름 및 코드 요소 ISO 웹 사이트입니다.For the current list of RegionInfo names, see English country names and code elements on the ISO website.

RegionInfo 개체 인스턴스화Instantiating a RegionInfo Object

인스턴스화하는 RegionInfo 개체를 전달 하는 RegionInfo(String) 생성자 중 두 문자 지역 등의 이름 "미국" 미국 또는 특정 문화권의 이름에는 "EN-US" 영어 (미국)와 같은 합니다.To instantiate a RegionInfo object, you pass the RegionInfo(String) constructor either a two-letter region name, such as "US" for the United States, or the name of a specific culture, such as "en-US" for English (United States). 그러나 좋습니다 특정 문화권 이름을 사용 하 여 두 문자 지역 이름 대신 때문에 RegionInfo 개체가 완전히 언어 독립적인 아닙니다.However, we recommend that you use a specific culture name instead of a two-letter region name, because a RegionInfo object is not completely language-independent. 몇 가지 RegionInfo 속성을 포함 하 여 DisplayNameNativeName, 및 CurrencyNativeName, 문화권 이름에 따라 달라 집니다.Several RegionInfo properties, including DisplayName, NativeName, and CurrencyNativeName, depend on culture names.

다음 예제에서 차이점을 보여 줍니다. RegionInfo 벨기에 나타내는 세 가지 개체에 대 한 속성 값입니다.The following example illustrates the difference in RegionInfo property values for three objects that represent Belgium. 문화권 이름에서 두 번째 및 세 번째 인스턴스화됩니다 하는 동안 첫 번째 지역 이름 (BE)만에서 인스턴스화됩니다 (fr-BE nl-BE 네덜란드어 (벨기에)에 대 한 프랑스어 (벨기에)에 각각).The first is instantiated from a region name (BE) only, while the second and third are instantiated from culture names (fr-BE for French (Belgium) and nl-BE for Dutch (Belgium), respectively). 이 예제에서는 리플렉션을 사용 하 여 각 속성 값을 검색할 RegionInfo 개체입니다.The example uses reflection to retrieve the property values of each RegionInfo object.

using System;
using System.Globalization;
using System.Reflection;

public class Example
{
   public static void Main()
   {
      // Instantiate three Belgian RegionInfo objects.
      RegionInfo BE = new RegionInfo("BE");
      RegionInfo frBE = new RegionInfo("fr-BE");
      RegionInfo nlBE = new RegionInfo("nl-BE");

      RegionInfo[] regions = { BE, frBE, nlBE };
      PropertyInfo[] props = typeof(RegionInfo).GetProperties(BindingFlags.Instance | BindingFlags.Public);
      
      Console.WriteLine("{0,-30}{1,18}{2,18}{3,18}\n", 
                        "RegionInfo Property", "BE", "fr-BE", "nl-BE");
      foreach (var prop in props) {
         Console.Write("{0,-30}", prop.Name);
         foreach (var region in regions)
            Console.Write("{0,18}", prop.GetValue(region, null));

         Console.WriteLine();
      }
   }
}
// The example displays the following output:
//    RegionInfo Property                           BE             fr-BE             nl-BE
//    
//    Name                                          BE             fr-BE             nl-BE
//    EnglishName                              Belgium           Belgium           Belgium
//    DisplayName                              Belgium           Belgium           Belgium
//    NativeName                                België          Belgique            België
//    TwoLetterISORegionName                        BE                BE                BE
//    ThreeLetterISORegionName                     BEL               BEL               BEL
//    ThreeLetterWindowsRegionName                 BEL               BEL               BEL
//    IsMetric                                    True              True              True
//    GeoId                                         21                21                21
//    CurrencyEnglishName                         Euro              Euro              Euro
//    CurrencyNativeName                          euro              euro              euro
//    CurrencySymbol                                 €                 €                 €
//    ISOCurrencySymbol                            EUR               EUR               EUR
Imports System.Globalization
Imports System.Reflection

Module Example
   Public Sub Main()
      ' Instantiate three Belgian RegionInfo objects.
      Dim BE As New RegionInfo("BE")
      Dim frBE As New RegionInfo("fr-BE")
      Dim nlBE As New RegionInfo("nl-BE")

      Dim regions() As RegionInfo = { BE, frBE, nlBE }
      Dim props() As PropertyInfo = GetType(RegionInfo).GetProperties(BindingFlags.Instance Or BindingFlags.Public)
      
      Console.WriteLine("{0,-30}{1,18}{2,18}{3,18}", 
                        "RegionInfo Property", "BE", "fr-BE", "nl-BE")
      Console.WriteLine()
      For Each prop As PropertyInfo In props
         Console.Write("{0,-30}", prop.Name)
         For Each region In regions
            Console.Write("{0,18}", prop.GetValue(region, Nothing))
         Next
         Console.WriteLine()
      Next
   End Sub
End Module
' The example displays the following output:
'    RegionInfo Property                           BE             fr-BE             nl-BE
'    
'    Name                                          BE             fr-BE             nl-BE
'    EnglishName                              Belgium           Belgium           Belgium
'    DisplayName                              Belgium           Belgium           Belgium
'    NativeName                                België          Belgique            België
'    TwoLetterISORegionName                        BE                BE                BE
'    ThreeLetterISORegionName                     BEL               BEL               BEL
'    ThreeLetterWindowsRegionName                 BEL               BEL               BEL
'    IsMetric                                    True              True              True
'    GeoId                                         21                21                21
'    CurrencyEnglishName                         Euro              Euro              Euro
'    CurrencyNativeName                          euro              euro              euro
'    CurrencySymbol                                 €                 €                 €
'    ISOCurrencySymbol                            EUR               EUR               EUR

다음과 같은 시나리오에서 사용 하 여 문화권 이름을 국가/지역 이름 대신 인스턴스화할 때를 RegionInfo 개체:In scenarios such as the following, use culture names instead of country/region names when you instantiate a RegionInfo object:

  • 때 언어 이름을 기본 중요도입니다.When the language name is of primary importance. 예를 들어, ES-US 문화권 이름에 대 한 싶을 "미국" 대신 "Estados Unidos"를 표시 하려면 애플리케이션입니다.For example, for the es-US culture name, you'll probably want your application to display "Estados Unidos" instead of "United States". (미국) 언어에 관계 없이 단독으로 생성 "미국" 국가/지역 이름을 사용 하므로 함께 해야 문화권 이름 대신 합니다.Using the country/region name (US) alone yields "United States" regardless of the language, so you should work with the culture name instead.

  • 때 스크립트 차이 고려해 야 합니다.When script differences must be considered. 예를 들어 AZ 국가/지역 이름 az-Latn-AZ 및 Cyrl-AZ-AZ, 라틴 문자 있는 Azerbaijani 문화권을 사용 하 여 처리 및 키릴 자모 스크립트는이 국가/지역에 대 한 매우 다를 수 있습니다.For example, the country/region AZ deals with Azerbaijani cultures that have the names az-Latn-AZ and az-Cyrl-AZ, and the Latin and Cyrillic scripts can be very different for this country/region.

  • 유지 관리 세부 경우 중요 합니다.When maintenance of detail is important. 반환 값 RegionInfo 멤버 여부에 따라 다를 수 있습니다는 RegionInfo 문화권 이름 또는 지역 이름을 사용 하 여 개체를 인스턴스화한 합니다.The values returned by RegionInfo members can differ depending on whether the RegionInfo object was instantiated by using a culture name or a region name. 예를 들어, 다음 표에 차이점 반환 될 때 값을 RegionInfo 개체 "미국" 지역, "EN-US" 문화권 및 es-"미국" 문화권을 사용 하 여 인스턴스화됩니다.For example, the following table lists the differences in return values when a RegionInfo object is instantiated by using the "US" region, the "en-US" culture, and the "es-US" culture.

    멤버Member "당사""US" "EN-US""en-US" es-"미국""es-US"
    CurrencyNativeName 미국 달러US Dollar 미국 달러US Dollar Dólar de EE 합니다. UU 합니다.Dólar de EE.UU.
    Name USUS en-USen-US es (미국)es-US
    NativeName 미국United States 미국United States Estados UnidosEstados Unidos
    ToString USUS en-USen-US es (미국)es-US

생성자

RegionInfo(Int32) RegionInfo(Int32) RegionInfo(Int32) RegionInfo(Int32)

지정된 문화권 식별자와 관련된 국가/지역을 기반으로 하는 RegionInfo 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the RegionInfo class based on the country/region associated with the specified culture identifier.

RegionInfo(String) RegionInfo(String) RegionInfo(String) RegionInfo(String)

이름에 의해 지정된 국가/지역 또는 특정 문화권을 기반으로 하여 RegionInfo 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the RegionInfo class based on the country/region or specific culture, specified by name.

속성

CurrencyEnglishName CurrencyEnglishName CurrencyEnglishName CurrencyEnglishName

국가/지역에서 사용되는 영어로 된 통화 이름을 가져옵니다.Gets the name, in English, of the currency used in the country/region.

CurrencyNativeName CurrencyNativeName CurrencyNativeName CurrencyNativeName

국가/지역에서 사용되는 통화 이름을 국가/지역의 네이티브 언어 형식으로 가져옵니다.Gets the name of the currency used in the country/region, formatted in the native language of the country/region.

CurrencySymbol CurrencySymbol CurrencySymbol CurrencySymbol

해당 국가/지역과 관련된 통화 기호를 가져옵니다.Gets the currency symbol associated with the country/region.

CurrentRegion CurrentRegion CurrentRegion CurrentRegion

현재 스레드에서 사용하는 국가/지역을 나타내는 RegionInfo를 가져옵니다.Gets the RegionInfo that represents the country/region used by the current thread.

DisplayName DisplayName DisplayName DisplayName

지역화된 .NET Framework 언어로 표시되는 해당 국가/지역의 전체 이름을 가져옵니다.Gets the full name of the country/region in the language of the localized version of .NET Framework.

EnglishName EnglishName EnglishName EnglishName

영어로 표시되는 해당 국가/지역의 전체 이름을 가져옵니다.Gets the full name of the country/region in English.

GeoId GeoId GeoId GeoId

지역, 국가, 도시 또는 위치에 대한 고유 식별 번호를 가져옵니다.Gets a unique identification number for a geographical region, country, city, or location.

IsMetric IsMetric IsMetric IsMetric

해당 국가/지역의 측정 단위가 미터법인지 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether the country/region uses the metric system for measurements.

ISOCurrencySymbol ISOCurrencySymbol ISOCurrencySymbol ISOCurrencySymbol

해당 국가/지역과 관련된 세 문자로 된 ISO 4217 통화 기호를 가져옵니다.Gets the three-character ISO 4217 currency symbol associated with the country/region.

Name Name Name Name

현재 RegionInfo 개체에 대한 이름 또는 ISO 3166 두 문자 국가/지역 코드를 가져옵니다.Gets the name or ISO 3166 two-letter country/region code for the current RegionInfo object.

NativeName NativeName NativeName NativeName

국가/지역의 이름은 국가/지역의 네이티브 언어 형식으로 가져옵니다.Gets the name of a country/region formatted in the native language of the country/region.

ThreeLetterISORegionName ThreeLetterISORegionName ThreeLetterISORegionName ThreeLetterISORegionName

해당 국가/지역에 대해 ISO 3166에 정의되어 있는 세 문자로 된 코드를 가져옵니다.Gets the three-letter code defined in ISO 3166 for the country/region.

ThreeLetterWindowsRegionName ThreeLetterWindowsRegionName ThreeLetterWindowsRegionName ThreeLetterWindowsRegionName

RegionInfo가 나타내는 국가/지역에 대해 Windows에서 할당한 세 문자로 된 코드를 가져옵니다.Gets the three-letter code assigned by Windows to the country/region represented by this RegionInfo.

TwoLetterISORegionName TwoLetterISORegionName TwoLetterISORegionName TwoLetterISORegionName

해당 국가/지역에 대해 ISO 3166에 정의되어 있는 두 문자로 된 코드를 가져옵니다.Gets the two-letter code defined in ISO 3166 for the country/region.

메서드

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

지정된 개체가 현재 RegionInfo와 같은 인스턴스인지 여부를 결정합니다.Determines whether the specified object is the same instance as the current RegionInfo.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

해시 알고리즘과 해시 테이블 같은 데이터 구조에 적합한 현재 RegionInfo에 대한 해시 함수의 역할을 합니다.Serves as a hash function for the current RegionInfo, suitable for hashing algorithms and data structures, such as a hash table.

GetType() GetType() GetType() GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

현재 RegionInfo에 지정된 문화권 이름 또는 ISO 3166 두 문자 국가/지역 코드가 들어 있는 문자열을 반환합니다.Returns a string containing the culture name or ISO 3166 two-letter country/region codes specified for the current RegionInfo.

적용 대상

추가 정보