Konstruktor System.Globalization.CultureAndRegionInfoBuilder

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

Artikel ini berkaitan dengan CultureAndRegionInfoBuilder(String, CultureAndRegionModifiers) konstruktor.

Parameter cultureName menentukan nama objek baru CultureAndRegionInfoBuilder .

Parameter flags digunakan untuk CultureAndRegionModifiers nilai yang menentukan apakah objek baru CultureAndRegionInfoBuilder adalah budaya kustom baru, atau menggantikan budaya netral yang ada, budaya tertentu, atau lokal Windows.

cultureName Jika parameter menentukan budaya .NET yang ada, budaya kustom terdaftar, atau budaya yang dihasilkan dari lokal Windows, CultureAndRegionInfoBuilder konstruktor secara otomatis mengisi objek baru CultureAndRegionInfoBuilder dengan informasi budaya dan negara/wilayah.

Isi objek baru CultureAndRegionInfoBuilder dengan informasi budaya dan negara/wilayah dengan memanggil LoadDataFromCultureInfo metode dan LoadDataFromRegionInfo .

Nama budaya kustom

Format cultureName parameter yang disukai untuk budaya kustom baru adalah "[-]language[prefix-region][-suffix[…]]", di mana language komponen diperlukan dan prefixkomponen , , regiondan suffix bersifat opsional. Panjang maksimum setiap komponen adalah 8 karakter dan panjang maksimum seluruh cultureName parameter adalah 84 karakter.

Komponennya prefix adalah identifikasi Internet Assigned Numbers Authority (IANA). Tentukan "i-" atau "I-" untuk nama budaya yang terdaftar di IANA, atau "x-" atau "X-" untuk nama budaya yang disediakan untuk penggunaan privat. Jika tidak, awalan tidak diperlukan. Untuk informasi selengkapnya, lihat RFC 4646, "Tag untuk Identifikasi Bahasa."

cultureName Komponen language parameter menentukan kode dua huruf kecil yang berasal dari ISO 639-1, dan region menentukan kode dua huruf besar yang berasal dari ISO 3166. Misalnya, en-US adalah singkatan dari bahasa Inggris seperti yang diucapkan dalam Amerika Serikat. Tidak adanya komponen menandakan region budaya netral.

cultureName Yang sama dengan nama budaya yang disertakan dengan .NET menandakan budaya pengganti (ambil alih). Nilai yang dapat ditetapkan ke properti budaya pengganti terbatas. Untuk informasi selengkapnya tentang batasan tersebut, lihat pengecualian untuk setiap properti.

Aplikasi ini menggunakan suffix komponen untuk membedakan budaya serupa. Misalnya, dua perusahaan, ABC dan XYZ, membuat dan berbagi layanan web ASP.NET baru untuk mempromosikan produk mereka di pasar yang berbeda di seluruh dunia. Halaman Web untuk layanan menampilkan informasi seperti logo regional dan nomor telepon lokal setiap perusahaan tergantung pada budaya pengguna. Konten khusus budaya untuk setiap halaman Web berada dalam file sumber daya terpisah yang diidentifikasi dengan nama budaya dan memenuhi syarat berdasarkan nama perusahaan. Misalnya, file sumber daya untuk budaya en-US dan ja-JP diberi nama en-US-ABC, en-US-XYZ, ja-JP-ABC, dan ja-JP-XYZ. Akhiran "ABC" dan "XYZ" memungkinkan layanan Web menggunakan logika aplikasi yang sama untuk menampilkan informasi khusus pasar yang berbeda.

Komponen suffix dapat terdiri dari subkomponen, di mana setiap subkomponen dibatasi oleh tanda hubung dan panjang maksimum setiap subkomponen adalah 8 karakter. Misalnya, jika "en-US-honda-cars" adalah cultureName parameter , "-honda-cars" adalah komponennya suffix .