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.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.


注釈

クラスとは異なりRegionInfo 、クラスはユーザー設定を表しておらず、ユーザーの言語やカルチャに依存しません。 CultureInfoUnlike 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 で定義されている国/地域の2文字のコードの1つです。The name of a RegionInfo object is one of the two-letter codes defined in ISO 3166 for country/region. 大文字と小文字は区別されません。Case is not significant. NameTwoLetterISORegionNameおよびThreeLetterISORegionNameの各プロパティは、適切なコードを大文字で返します。The Name, TwoLetterISORegionName, and ThreeLetterISORegionName properties return the appropriate codes in uppercase. 現在の名前のRegionInfo一覧については、ISO web サイトの「英語の国名とコード要素」を参照してください。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)コンストラクターに2文字の領域名 (米国の "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オブジェクトは完全に言語に依存しないため、2文字の領域名の代わりに特定のカルチャ名を使用することをお勧めします。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. DisplayNameRegionInfo 、などのいくつかのプロパティは、カルチャ名によって異なります。NativeName CurrencyNativeNameSeveral RegionInfo properties, including DisplayName, NativeName, and CurrencyNativeName, depend on culture names.

次の例は、ベルギーをRegionInfo表す3つのオブジェクトのプロパティ値の違いを示しています。The following example illustrates the difference in RegionInfo property values for three objects that represent Belgium. 1つ目のは領域名 (BE) からのみインスタンス化され、2番目と3番目のはカルチャ名からインスタンス化されます (フランス語 (ベルギー) の場合は fr-fr、オランダ語 (ベルギー) の場合は 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-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-us" カルチャを使用してインスタンス化された場合の戻り値の違いを示しています。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-US""es-US"
    CurrencyNativeName 米国ドルUS Dollar 米国ドルUS Dollar Dólar de EE.UU.Dólar de EE.UU.
    Name USUS en-USen-US es-USes-US
    NativeName 米国United States 米国United States Estados UnidosEstados Unidos
    ToString USUS en-USen-US es-USes-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

国/地域に関連付けられた 3 文字の ISO 4217 通貨記号を取得します。Gets the three-character ISO 4217 currency symbol associated with the country/region.

Name Name Name Name

現在の RegionInfo オブジェクトの名前、または ISO 3166 で定義された 2 文字の国/地域コードを取得します。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 で定義された国/地域の 3 文字コードを取得します。Gets the three-letter code defined in ISO 3166 for the country/region.

ThreeLetterWindowsRegionName ThreeLetterWindowsRegionName ThreeLetterWindowsRegionName ThreeLetterWindowsRegionName

RegionInfo が表す国/地域に対して Windows が割り当てた 3 文字コードを取得します。Gets the three-letter code assigned by Windows to the country/region represented by this RegionInfo.

TwoLetterISORegionName TwoLetterISORegionName TwoLetterISORegionName TwoLetterISORegionName

ISO 3166 で定義された国/地域の 2 文字コードを取得します。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 で定義された 2 文字の国/地域コードを含む文字列を返します。Returns a string containing the culture name or ISO 3166 two-letter country/region codes specified for the current RegionInfo.

適用対象

こちらもご覧ください