ApplicationLanguages Kelas

Referensi

Definisi

Ruang nama:: Windows.Globalization

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.

Edit

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: Object Platform::Object IInspectable ApplicationLanguages

Atribut: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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).

Berlaku untuk