ApplicationLanguages クラス

定義

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 の要件

注釈

このクラスで参照される言語は、 BCP-47 言語タグで表されます。 これらはそれぞれ言語識別子であり、ロケール名ではありません。ただし、2 つの構造は同じにすることができます。 言語タグとして、"en-US" はアメリカ英語 (または米国で話される英語の方言) を意味します。 話者の実際の場所に関する主張は行いません (ただし、その多くは米国に存在します)、測定システムや通貨など、米国で使用される規則に関するその他の主張はありません。

例:

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

言語タグは、Unicode 拡張機能 "ca-" と "nu-" をサポートしています。 (「 Unicode キー/型定義」を参照してください)。これらの拡張機能は、グローバリゼーション オブジェクトで使用される数字システムまたはカレンダーに影響を与える可能性があることに注意してください。

UWP アプリは、リソース パッケージを使用して展開できます。 言語リソース パッケージを使用する場合、特定のユーザーにインストールおよび登録されるパッケージは、ユーザーの言語プロファイルの言語によって決まります。 その結果、Microsoft Store に送信されたアプリ バンドルに含まれるすべての言語が実行時に使用できるとは限りません。 PrimaryLanguageOverride プロパティは、ユーザーが使用できる言語にのみ設定する必要があります。

実行時にアプリケーションで ApplicationLanguages オブジェクトとして使用できる言語は、メイン アプリ パッケージ マニフェストに含まれる言語と、ユーザーに適用できる言語リソース パッケージに対応する言語 (ユーザーの設定で一致する言語によって決定されます)、ユーザーにインストールおよび登録されている言語に制限されます。 ApplicationLanguages.ManifestLanguages プロパティは、ユーザーが使用できる言語リソース パッケージを反映し、PrimaryLanguageOverride プロパティの設定に使用できる適切な言語セットを返します。

ApplicationLanguages.Languages プロパティは、ManifestLanguages プロパティとよく似たリストを返します。 パッケージ マニフェストに記載されていない地域言語のバリエーションを含めることは異なる場合があります。たとえば、ユーザーがプロファイルに "en-CA" を持ち、アプリが任意の地域の英語をサポートしている場合、 Languages プロパティから "en-CA" (英語 (カナダ)) を返すことができます。 このようなユーザー派生の地域言語のバリエーションは、アプリがユーザーにより適切なグローバリゼーション動作を提供するため、 PrimaryLanguageOverride プロパティを設定する場合に適しています。

言語がメイン アプリ パッケージ内にあり、ユーザーの好みの言語と一致しない場合は、ManifestLanguages プロパティによって返されますが、Languages プロパティは返されません。 これらは、 PrimaryLanguageOverride プロパティの設定にも使用できます。 ただし、これらの言語はユーザーの設定に反映されないため、ユーザーはこれらの言語を理解していない可能性があります。 このような設定は、ユーザーが直接選択した場合にのみ使用する必要があります。

バージョン履歴

プロパティ

メソッド

適用対象

こちらもご覧ください

• BCP-47 言語タグに関するページ
• Unicode キー/型の定義