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.

「に関連付けられた名前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.

「をインスタンス化するInstantiating a RegionInfo Object

インスタンス化する、RegionInfoオブジェクトを渡す、RegionInfo(String)コンス トラクターの 2 文字の地域名か、英語 (米国) の"EN-US"など、米国または特定のカルチャの名前を"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). ただし、お勧めします 2 文字の地域名の代わりに、特定のカルチャ名を使用しているため、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ベルギーを表す 3 つのオブジェクトのプロパティ値。The following example illustrates the difference in RegionInfo property values for three objects that represent Belgium. カルチャ名からインスタンス化は、2 番目と 3 番目からリージョン名 (BE) のみ、1 つ目がインスタンス化される (フランス語 (ベルギー) および nl-オランダ語 (ベルギー) の fr-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 米国のカルチャ名を"United States"ではなく"Estados Unidos"を表示するアプリケーション可能性がありますするします。For example, for the es-US culture name, you'll probably want your application to display "Estados Unidos" instead of "United States". (米国) 言語にかかわらず生成"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-Latn-AZ az アゼルバイジャン、AZ およびラテン文字を扱う、国/地域 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 「米国」リージョン、"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

国/地域に関連付けられた 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.

適用対象

こちらもご覧ください