CultureAndRegionInfoBuilder kelas

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

Catatan

Kelas CultureAndRegionInfoBuilder ini hanya berguna untuk sistem operasi Windows. File .nlp yang dihasilkan tidak didukung pada sistem operasi non-Windows. Selain itu, bahkan di Windows, file .nlp yang dihasilkan hanya didukung pada .NET Framework (atau di .NET Core saat menggunakan mode globalisasi NLS).

Kelas ini CultureInfo menyimpan informasi khusus budaya, seperti bahasa terkait, sublanguage, negara/wilayah, kalender, dan konvensi budaya. Kelas ini juga menyediakan instans khusus budaya dari DateTimeFormatInfokelas , , NumberFormatInfoCompareInfo, dan TextInfo , yang diperlukan untuk operasi khusus budaya seperti casing, pemformatan dan penguraian tanggal dan angka, dan membandingkan string.

Secara default, .NET mendukung CultureInfo objek yang mewakili sekumpulan budaya yang telah ditentukan sebelumnya. Untuk daftar budaya ini yang tersedia di sistem Windows, lihat kolom Tag bahasa dalam daftar nama bahasa/wilayah yang didukung oleh Windows. Nama budaya mengikuti standar yang ditentukan oleh BCP 47. Kelas ini CultureAndRegionInfoBuilder memungkinkan Anda untuk membuat budaya kustom yang benar-benar baru atau yang mengambil alih budaya yang telah ditentukan. Ketika budaya kustom dipasang dan didaftarkan pada komputer tertentu, itu menjadi tidak dapat dibedakan dari objek yang telah CultureInfo ditentukan sebelumnya, dan dapat dibuat dan digunakan sama seperti objek-objek tersebut.

Penting

Kelas CultureAndRegionInfoBuilder ini ditemukan di rakitan bernama sysglobl.dll. Agar berhasil mengkompilasi kode yang menggunakan jenis ini, Anda harus menambahkan referensi ke sysglobl.dll.

Budaya kustom hanya dapat didaftarkan di komputer oleh pengguna yang memiliki hak administratif di komputer tersebut. Akibatnya, aplikasi biasanya tidak membuat dan menginstal budaya kustom. Sebagai gantinya CultureAndRegionInfoBuilder , Anda dapat menggunakan kelas untuk membuat alat tujuan khusus yang dapat digunakan administrator untuk membuat, menginstal, dan mendaftarkan budaya kustom. Setelah budaya kustom terdaftar di komputer, Anda dapat menggunakan CultureInfo kelas di aplikasi Anda untuk membuat instans budaya kustom seperti yang Anda lakukan untuk budaya yang telah ditentukan sebelumnya.

Jika Anda mengurai string tanggal dan waktu yang dihasilkan untuk budaya kustom, Anda harus menggunakan DateTime.ParseExact metode atau DateTime.TryParseExact alih-alih DateTime.Parse metode atau DateTime.TryParse untuk meningkatkan probabilitas bahwa operasi penguraian akan berhasil. String tanggal dan waktu untuk budaya kustom bisa rumit dan karenanya sulit diurai. Metode Parse dan TryParse mencoba mengurai string dengan beberapa pola penguraian implisit, yang semuanya mungkin gagal. Metode ini TryParseExact , sebaliknya, mengharuskan aplikasi untuk secara eksplisit menunjuk satu atau beberapa pola penguraian yang tepat yang kemungkinan akan berhasil.

Menentukan dan membuat budaya kustom

Anda menggunakan CultureAndRegionInfoBuilder kelas untuk menentukan dan memberi nama budaya kustom. Budaya kustom dapat menjadi budaya yang sama sekali baru, budaya baru yang didasarkan pada budaya yang ada (yaitu, budaya tambahan), atau budaya yang menggantikan budaya .NET yang ada. Dalam setiap kasus, langkah-langkah dasarnya sama:

1. Buat instans CultureAndRegionInfoBuilder objek dengan memanggil konstruktornya CultureAndRegionInfoBuilder(String, CultureAndRegionModifiers) . Untuk mengganti budaya yang ada, berikan nama budaya itu CultureAndRegionModifiers.Replacement dan nilai enumerasi ke konstruktor. Untuk menciptakan budaya baru atau budaya tambahan, berikan nama budaya yang unik dan nilai CultureAndRegionModifiers.Neutral atau CultureAndRegionModifiers.None enumerasi.

   Catatan

   Jika Anda menggunakan CultureAndRegionModifiers.Replacement nilai enumerasi untuk membuat CultureAndRegionInfoBuilder instans objek, CultureAndRegionInfoBuilder properti objek secara otomatis diisi dengan nilai dari objek yang CultureInfo akan diganti.

2. Jika Anda membuat budaya baru atau tambahan:

   • Isi CultureAndRegionInfoBuilder properti objek dengan memanggil LoadDataFromCultureInfo metode dan meneruskan CultureInfo objek yang nilai propertinya mirip dengan objek baru Anda.
   • Isi CultureAndRegionInfoBuilder properti regional objek dengan memanggil LoadDataFromRegionInfo metode dan meneruskan RegionInfo objek yang mewakili wilayah budaya kustom Anda.

3. Ubah properti objek seperlunya CultureAndRegionInfoBuilder .

4. Jika Anda berencana untuk mendaftarkan budaya kustom dalam rutinitas terpisah, panggil metode .Save Ini menghasilkan file XML yang dapat Anda muat dan daftarkan dalam rutinitas penginstalan budaya kustom terpisah.

Mendaftarkan budaya kustom

Jika Anda mengembangkan aplikasi pendaftaran untuk budaya kustom yang terpisah dari aplikasi yang membuat budaya, Anda memanggil CreateFromLdml metode untuk memuat file XML yang berisi definisi budaya kustom dan membuat instans CultureAndRegionInfoBuilder objek. Untuk menangani pendaftaran, panggil Register metode . Agar pendaftaran berhasil, aplikasi yang mendaftarkan budaya kustom harus berjalan dengan hak istimewa administratif pada sistem target; jika tidak, panggilan untuk Register melemparkan UnauthorizedAccessException pengecualian.

Peringatan

Data budaya dapat berbeda antar sistem. Jika Anda menggunakan CultureAndRegionInfoBuilder kelas untuk membuat budaya kustom yang seragam di beberapa sistem dan Anda membuat budaya kustom Anda dengan memuat data dari objek dan RegionInfo yang ada CultureInfo dan menyesuaikannya, Anda harus mengembangkan dua utilitas yang berbeda. Yang pertama membuat budaya kustom dan menyimpannya ke file XML. Yang kedua menggunakan CreateFromLdml metode untuk memuat budaya kustom dari file XML dan mendaftarkannya di komputer target.

Proses pendaftaran melakukan tugas-tugas berikut:

• Membuat file .nlp yang berisi informasi yang ditentukan dalam CultureAndRegionInfoBuilder objek.
• Menyimpan file .nlp di direktori sistem %windir%\Globalisasi pada komputer target. Ini memungkinkan pengaturan budaya kustom untuk bertahan di antara sesi. (Metode CultureAndRegionInfoBuilder ini memerlukan hak administratif karena file .nlp disimpan dalam direktori sistem.)
• Menyiapkan .NET untuk mencari direktori sistem %windir%\Globalisasi alih-alih cache internal lain kali ada permintaan untuk membuat budaya kustom baru Anda.

Ketika budaya kustom berhasil didaftarkan, itu tidak dapat dibedakan dari budaya yang telah ditentukan sebelumnya oleh .NET. Budaya kustom tersedia hingga panggilan ke CultureAndRegionInfoBuilder metode menghapus file .nlp dari komputer lokal.

Membuat instans budaya kustom

Anda dapat membuat instans budaya kustom dengan salah satu cara berikut:

• Dengan memanggil CultureInfo.CultureInfo konstruktor dengan nama budaya.
• Dengan memanggil CultureInfo.CreateSpecificCulture metode dengan nama budaya.
• Dengan memanggil CultureInfo.GetCultureInfo metode dengan nama budaya.

Selain itu, array CultureInfo objek yang dikembalikan oleh CultureInfo.GetCultures metode termasuk budaya kustom.