ApplicationLanguages.PrimaryLanguageOverride 屬性

定義

命名空間:

Windows.Globalization

取得或設定應用程式慣用語言的覆寫，以 BCP-47 語言標籤表示。 此設定會保存。

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

屬性值

String

Platform::String

winrt::hstring

BCP-47語言標籤。 應用程式可以設定為覆寫使用者排名語言清單的最上層語言， (ApplicationLanguages.Languages) ，且其值將會保存在應用程式會話之間。 它必須是單一語言標籤;語言標記的分隔清單將會失敗。

當您的應用程式取得值時，如果您的 app 先前已設定屬性) 或空字串，PrimaryLanguageOverride 會傳回單一語言標籤 (。

備註

應用程式通常會以系統所決定的語言設定來執行，方法是比較應用程式所支援的語言與使用者的語言喜好設定。 您可以使用 ApplicationLanguages.Languages 屬性取得該系統行為的設定。 PrimaryLanguageOverride 屬性是用來覆寫該行為，方法是將特定語言設定為語言清單中的第一種語言。

PrimaryLanguageOverride 設定會在會話之間保存。 每次載入應用程式時，不應該設定它。 它應該只根據設定 UI 中顯示的使用者輸入來設定。 屬性可以隨時讀取。 如果屬性從未設定過，則會傳回空字串。

當您設定 PrimaryLanguageOverride 時，這會立即反映在 ApplicationLanguages.Languages 屬性中。 不過，這項變更可能不會立即對應用程式 UI 中載入的資源生效。 若要確定應用程式回應這類變更，您可以接聽預設資源內容的 QualifierValues 屬性，並採取任何可能需要重載資源的動作。 這些需求可能會因應用程式所使用的 UI 架構而有所不同，而且可能需要重新開機應用程式。

另請參閱

• Languages
• BCP-47 語言標記