RegionInfo kelas

Artikel ini menyediakan keterangan tambahan untuk dokumentasi referensi untuk API ini.

CultureInfo Tidak seperti kelas , RegionInfo kelas tidak mewakili preferensi pengguna dan tidak bergantung pada bahasa atau budaya pengguna.

Nama yang terkait dengan objek RegionInfo

Nama RegionInfo objek adalah salah satu kode dua huruf yang ditentukan dalam ISO 3166 untuk negara/wilayah. Kasus tidak signifikan. Properti Name, TwoLetterISORegionName, dan ThreeLetterISORegionName mengembalikan kode yang sesuai dalam huruf besar. Untuk daftar RegionInfo nama saat ini, lihat ISO 3166: Kode negara.

Membuat instans objek RegionInfo

Untuk membuat RegionInfo instans objek, Anda meneruskan RegionInfo(String) konstruktor baik nama wilayah dua huruf, seperti "AS" untuk Amerika Serikat, atau nama budaya tertentu, seperti "en-US" untuk bahasa Inggris (Amerika Serikat). Namun, kami sarankan Anda menggunakan nama budaya tertentu alih-alih nama wilayah dua huruf, karena RegionInfo objek tidak sepenuhnya independen bahasa. Beberapa RegionInfo properti, termasuk DisplayName, NativeName, dan CurrencyNativeName, tergantung pada nama budaya.

Contoh berikut mengilustrasikan perbedaan RegionInfo nilai properti untuk tiga objek yang mewakili Belgia. Yang pertama dibuat dari nama wilayah (BE) saja, sementara yang kedua dan ketiga dibuat dari nama budaya (fr-BE untuk Prancis (Belgia) dan nl-BE untuk Belanda (Belgia), masing-masing). Contoh menggunakan pantulan untuk mengambil nilai properti dari setiap RegionInfo objek.

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

Dalam skenario seperti berikut ini, gunakan nama budaya alih-alih nama negara/wilayah saat Anda membuat RegionInfo instans objek:

• Ketika nama bahasa sangat penting. Misalnya, untuk es-US nama budaya, Anda mungkin ingin aplikasi Anda menampilkan "Estados Unidos" alih-alih "Amerika Serikat". Menggunakan nama negara/wilayah (US) saja menghasilkan "Amerika Serikat" terlepas dari bahasanya, jadi Anda harus bekerja dengan nama budaya sebagai gantinya.

• Ketika perbedaan skrip harus dipertimbangkan. Misalnya, negara/wilayah AZ berkaitan dengan budaya Azerbaijan yang memiliki nama az-Latn-AZ dan az-Cyrl-AZ, dan skrip Latin dan Sirilik bisa sangat berbeda untuk negara/wilayah ini.

• Ketika pemeliharaan detail penting. Nilai yang dikembalikan oleh RegionInfo anggota dapat berbeda tergantung pada apakah RegionInfo objek dibuat dengan menggunakan nama budaya atau nama wilayah. Misalnya, tabel berikut mencantumkan perbedaan nilai pengembalian ketika RegionInfo objek dibuat dengan menggunakan wilayah "AS", budaya "en-US", dan budaya "es-AS".

  Anggota	"US"	"en-US"	"es-US"
  CurrencyNativeName	US Dollar	US Dollar	Dólar de EE.UU.
  Name	US	en-US	es-US
  NativeName	United States	United States	Estados Unidos
  ToString	US	en-US	es-US