ApplicationLanguages 類別

定義

命名空間:

Windows.Globalization

指定應用程式可以使用和維護的語言相關喜好設定。

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

繼承

Object Platform::Object IInspectable ApplicationLanguages

屬性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 需求

裝置系列	Windows 10 (已於 10.0.10240.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

備註

此類別中參考的語言是以 BCP-47 語言標記表示。 其中每一個都是語言識別項，而不是地區設定名稱，雖然兩個結構上可以相同。 作為語言標記，「en-US」 表示美式英文 (或美國) 中說出的英文方言。 它不會對說話者的實際位置提出任何宣告 (，但其中許多說話者都位於美國) ，而且沒有其他有關美國慣例的宣告，例如測量系統或貨幣。

範例：

Windows.Globalization.ApplicationLanguages.PrimaryLanguageOverride = "en-US"

注意

如果您的應用程式將語言標籤從這個類別傳遞至任何 國家語言支援 函式，則必須先呼叫 ResolveLocaleName來轉換標籤。

語言標籤支援 Unicode 延伸模組 「ca-」 和 「nu-」。 (請參閱 Unicode 索引鍵/類型定義.) 請注意，這些延伸模組可能會影響全球化物件所使用的數字系統或行事曆。

UWP 應用程式可以使用資源套件進行部署。 使用語言資源套件時，為指定使用者安裝並註冊的套件取決於使用者語言設定檔中的語言。 因此，並非所有提交至 Microsoft Store 的應用程式套件組合中包含的語言，都必須可在執行時間使用。 PrimaryLanguageOverride屬性應該只設定為使用者可用的語言。

應用程式可在執行時間當做 ApplicationLanguages 物件使用的語言受限於主要應用程式套件資訊清單中包含的語言，以及對應至使用者語言資源套件的語言，這些語言適用于使用者， (由使用者喜好設定) 中的比對語言所決定，以及為使用者安裝及註冊的語言。 ApplicationLanguages.ManifestLanguages屬性會反映使用者可用的語言資源套件，並傳回可用於設定PrimaryLanguageOverride屬性的適當語言集。

ApplicationLanguages.Languages屬性會傳回與ManifestLanguages屬性非常類似的清單。 它可能不同，包括未列在任何套件資訊清單中的地區語言變化;例如，如果使用者的設定檔中有 「en-CA」 ，且應用程式支援任何地區不同的英文，則 語言屬性可以 傳回 「en-CA」 (English (Canada) ) 。 這類使用者衍生的區域語言變化最好是設定 PrimaryLanguageOverride 屬性，因為應用程式接著會為使用者提供更適當的全球化行為。

如果語言位於主要應用程式套件中，但與使用者喜好設定中的任何語言不相符， 則會由 ManifestLanguages 屬性傳回，而不是 Languages 屬性。 這些也可以用來設定 PrimaryLanguageOverride 屬性。 不過，由於這些語言不會反映在使用者的喜好設定中，因此使用者可能無法瞭解這些語言。 只有在使用者直接選擇時，才應該使用這類設定。

版本歷程記錄

Windows 版本	SDK 版本	已新增值
1803	17134	GetLanguagesForUser

屬性

Languages	取得使用者慣用之目前執行時間語言值的排名清單。
ManifestLanguages	取得應用程式的宣告支援語言清單。
PrimaryLanguageOverride	取得或設定應用程式慣用語言的覆寫，以 BCP-47 語言標籤表示。 此設定會保存。

方法

GetLanguagesForUser(User)

擷取指定使用者的語言喜好設定。 此 API 是多使用者應用程式 (MUA) 支援的一部分。

另請參閱

• BCP-47 語言標記
• Unicode 索引鍵/類型定義