ApplicationLanguages.PrimaryLanguageOverride Properti

Definisi

Ruang nama:

Windows.Globalization

Mendapatkan atau mengatur penimpaan untuk bahasa pilihan aplikasi, yang dinyatakan sebagai tag bahasa BCP-47 . Pengaturan ini tetap ada.

public:
 static property Platform::String ^ PrimaryLanguageOverride { Platform::String ^ get(); void set(Platform::String ^ value); };

static winrt::hstring PrimaryLanguageOverride();

static void PrimaryLanguageOverride(winrt::hstring value);

public static string PrimaryLanguageOverride { get; set; }

var string = ApplicationLanguages.primaryLanguageOverride;
ApplicationLanguages.primaryLanguageOverride = string;

Public Shared Property PrimaryLanguageOverride As String

Nilai Properti

String

Platform::String

winrt::hstring

Tag bahasa BCP-47 . Aplikasi ini dapat mengaturnya untuk mengambil alih bahasa teratas daftar peringkat pengguna dari bahasa pilihan (ApplicationLanguages.Languages), dan nilainya akan bertahan di antara sesi aplikasi. Ini harus berupa tag bahasa tunggal; daftar tag bahasa yang dibatasi akan gagal.

Saat aplikasi Anda mendapatkan nilainya, PrimaryLanguageOverride mengembalikan satu tag bahasa (jika aplikasi Anda sebelumnya telah mengatur properti ) atau string kosong.

Keterangan

Aplikasi biasanya berjalan dengan pengaturan bahasa yang ditentukan oleh sistem dengan membandingkan bahasa yang didukung oleh aplikasi dengan preferensi bahasa pengguna. Pengaturan untuk perilaku sistem tersebut dapat diperoleh menggunakan properti ApplicationLanguages.Languages . Properti PrimaryLanguageOverride digunakan untuk mengambil alih perilaku tersebut dengan mengatur bahasa tertentu sebagai bahasa pertama dalam daftar Bahasa.

Pengaturan PrimaryLanguageOverride tetap ada di antara sesi. Ini tidak boleh diatur setiap kali aplikasi dimuat. Ini hanya boleh diatur berdasarkan input pengguna yang disajikan di antarmuka pengguna pengaturan. Properti dapat dibaca kapan saja. Jika properti belum pernah diatur, properti akan mengembalikan string kosong.

Ketika Anda mengatur PrimaryLanguageOverride, ini segera tercermin dalam properti ApplicationLanguages.Languages . Namun, perubahan ini mungkin tidak segera berlaku pada sumber daya yang dimuat di antarmuka pengguna aplikasi. Untuk memastikan aplikasi merespons perubahan tersebut, Anda dapat mendengarkan properti QualifierValues pada konteks sumber daya default dan mengambil tindakan apa pun yang mungkin diperlukan untuk memuat ulang sumber daya. Persyaratan tersebut dapat bervariasi tergantung pada kerangka kerja UI yang digunakan oleh aplikasi, dan mungkin perlu untuk menghidupkan ulang aplikasi.

Lihat juga

• Languages
• Tag bahasa BCP-47