RegionInfo 클래스

정의

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

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

예제

다음 예제에서는 클래스의 여러 멤버를 보여 줍니다 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.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

End Class


'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) 생성자를 두 문자로 된 지역 이름 (예: 미국에 대 한 "US") 또는 영어 (미국)의 경우 "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, 및를 비롯 한 여러 속성은 DisplayName NativeName 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) 에서만 인스턴스화되고, 두 번째 및 세 번째는 문화권 이름 (프랑스어 (벨기에)의 경우 nl, 네덜란드어 (벨기에)의 경우)에서 인스턴스화됩니다.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". 국가/지역 이름 (US)만 사용 하면 언어에 관계 없이 "미국"이 생성 되므로 대신 문화권 이름을 사용 해야 합니다.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 및 az-Cyrl-AZ 인 아제르바이잔어 문화권을 다루지만, 라틴어 및 키릴 자모 스크립트는이 국가/지역에 대해 매우 다를 수 있습니다.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 "us" 지역, "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 ko-KRen-US es-USes-US
    NativeName 미국United States 미국United States EstadosEstados Unidos
    ToString USUS ko-KRen-US es-USes-US

생성자

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 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the RegionInfo class based on the country/region or specific culture, specified by name.

속성

CurrencyEnglishName

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

CurrencyNativeName

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

CurrencySymbol

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

CurrentRegion

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

DisplayName

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

EnglishName

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

GeoId

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

IsMetric

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

ISOCurrencySymbol

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

Name

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

NativeName

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

ThreeLetterISORegionName

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

ThreeLetterWindowsRegionName

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

TwoLetterISORegionName

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

메서드

Equals(Object)

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

GetHashCode()

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

GetType()

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

(다음에서 상속됨 Object)
MemberwiseClone()

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

(다음에서 상속됨 Object)
ToString()

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

적용 대상

추가 정보