ApplicationLanguages Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Menentukan preferensi terkait bahasa yang dapat digunakan dan dikelola aplikasi.
public ref class ApplicationLanguages abstract sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ApplicationLanguages final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public static class ApplicationLanguages
Public Class ApplicationLanguages
- Warisan
- Atribut
Persyaratan Windows
Rangkaian perangkat |
Windows 10 (diperkenalkan dalam 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)
|
Keterangan
Bahasa yang direferensikan dalam kelas ini diwakili oleh tag bahasa BCP-47. Masing-masing adalah pengidentifikasi bahasa dan bukan nama lokal, meskipun keduanya secara struktural bisa sama. Sebagai tag bahasa, "en-US" berarti Bahasa Inggris Amerika (atau dialek bahasa Inggris yang digunakan dalam Amerika Serikat). Ini tidak membuat klaim tentang lokasi aktual pembicara (meskipun banyak dari mereka berada di AS) dan tidak ada klaim lain tentang konvensi yang digunakan di AS seperti sistem pengukuran atau mata uang.
Contoh:
Windows.Globalization.ApplicationLanguages.PrimaryLanguageOverride = "en-US"
Catatan
Jika aplikasi Anda meneruskan tag bahasa dari kelas ini ke fungsi Dukungan Bahasa Nasional apa pun, aplikasi harus terlebih dahulu mengonversi tag dengan memanggil ResolveLocaleName.
Tag bahasa mendukung ekstensi Unicode "ca-" dan "nu-". (Lihat Definisi Kunci/Jenis Unicode.) Perhatikan bahwa ekstensi ini dapat memengaruhi sistem numeral atau kalender yang digunakan oleh objek globalisasi.
Aplikasi UWP dapat disebarkan menggunakan paket sumber daya. Saat paket sumber daya bahasa digunakan, paket yang diinstal dan didaftarkan untuk pengguna tertentu ditentukan oleh bahasa di profil bahasa pengguna. Akibatnya, tidak semua bahasa yang disertakan dalam bundel aplikasi yang dikirimkan ke Microsoft Store akan selalu tersedia untuk digunakan saat runtime. Properti PrimaryLanguageOverride hanya boleh diatur ke bahasa yang tersedia untuk pengguna.
Bahasa yang tersedia untuk digunakan aplikasi sebagai objek ApplicationLanguages saat runtime terbatas pada bahasa yang disertakan dalam manifes paket aplikasi utama dan bahasa yang sesuai dengan paket sumber daya bahasa yang berlaku untuk pengguna (ditentukan oleh bahasa yang cocok dalam preferensi pengguna), dan yang diinstal dan didaftarkan untuk pengguna. Properti ApplicationLanguages.ManifestLanguages mencerminkan paket sumber daya bahasa yang tersedia untuk pengguna, dan mengembalikan sekumpulan bahasa yang sesuai yang dapat digunakan untuk mengatur properti PrimaryLanguageOverride .
Properti ApplicationLanguages.Languages akan mengembalikan daftar yang sangat mirip dengan properti ManifestLanguages . Ini mungkin berbeda dalam termasuk variasi bahasa regional yang tidak tercantum dalam manifes paket apa pun; misalnya, "en-CA" (Inggris (Kanada)) dapat dikembalikan oleh properti Bahasa jika pengguna memiliki "en-CA" di profil mereka dan aplikasi mendukung berbagai bahasa Inggris regional. Variasi bahasa regional turunan pengguna tersebut dapat lebih disukai untuk mengatur properti PrimaryLanguageOverride karena aplikasi kemudian akan memberikan perilaku globalisasi yang lebih sesuai untuk pengguna.
Jika bahasa berada dalam paket aplikasi utama tetapi tidak cocok untuk bahasa apa pun di preferensi pengguna, bahasa tersebut dikembalikan oleh properti ManifestLanguages tetapi bukan properti Bahasa . Ini juga dapat digunakan untuk mengatur properti PrimaryLanguageOverride . Namun, karena bahasa ini tidak tercermin dalam preferensi pengguna, pengguna mungkin tidak memahami bahasa tersebut. Pengaturan tersebut harus digunakan hanya ketika dipilih langsung oleh pengguna.
Riwayat versi
Versi Windows | Versi SDK | Nilai ditambahkan |
---|---|---|
1803 | 17134 | GetLanguagesForUser |
Properti
Languages |
Mendapatkan daftar peringkat nilai bahasa runtime saat ini yang lebih disukai oleh pengguna. |
ManifestLanguages |
Mendapatkan daftar bahasa yang didukung aplikasi yang dinyatakan. |
PrimaryLanguageOverride |
Mendapatkan atau mengatur penimpaan untuk bahasa pilihan aplikasi, yang dinyatakan sebagai tag bahasa BCP-47 . Pengaturan ini tetap ada. |
Metode
GetLanguagesForUser(User) |
Mengambil preferensi bahasa pengguna yang ditentukan. API ini adalah bagian dari dukungan untuk aplikasi multi-pengguna (MUA). |