Language 类

定义

命名空间:

Windows.Globalization

提供与 BCP-47 语言标记（如语言名称和脚本）相关的信息的类。

public ref class Language 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)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Globalization.ILanguageFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class Language 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)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Globalization.ILanguageFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class Language

function Language(languageTag)

Public NotInheritable Class Language

继承

Object Platform::Object IInspectable Language

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

示例

// Get the top user-preferred language and its display name.
var topUserLanguage = Windows.System.UserProfile.GlobalizationPreferences.Languages[0];
var language = new Windows.Globalization.Language(topUserLanguage);
var displayName = language.DisplayName;

注解

如果你的应用将此类中使用的语言标记传递给任何 国家/地区语言支持 函数，则它必须首先通过调用 ResolveLocaleName 来转换标记。

使用 BCP-47 语言标记初始化此类。 例如，若要使用当前用户首选的最佳语言，请传入 Windows.System.UserProfile.GlobalizationPreferences 中的顶级值：

语言标记支持 Unicode 扩展“ca-”和“nu-”。 (请参阅 Unicode 键/类型定义。) 请注意，这些扩展可能会影响 Calendar 对象使用的日历。

版本历史记录

Windows 版本	SDK 版本	增值
1803	17134	LayoutDirection
2004	19041	AbbreviatedName
2004	19041	GetMuiCompatibleLanguageListFromLanguageTags

构造函数

Language(String)

创建 Language 对象。

属性

AbbreviatedName	获取 BCP-47 语言标记的三个字母缩写。 例如，“en-US”将转换为“eng”。
CurrentInputMethodLanguageTag	获取当前启用的键盘布局或输入法编辑器 (输入法) 的 BCP-47 语言标记。
DisplayName	获取适合向用户显示以标识语言的本地化字符串。
LanguageTag	获取此语言的规范化 BCP-47 语言标记。
LayoutDirection	获取最适合语言的文本和 UI 元素 (的内容布局方向) 。
NativeName	获取语言本身中语言的名称。
Script	获取语言的四个字母 ISO 15924 脚本代码。

方法

GetExtensionSubtags(String)	检索由单一实例标识的给定扩展的当前语言的扩展子标记向量。
GetMuiCompatibleLanguageListFromLanguageTags(IIterable<String>)	检索一组 多语言用户界面 (MUI) 从一个或多个 BCP-47 语言标记派生的标记。
IsWellFormed(String)	确定 BCP-47 语言标记的格式是否正确。
TrySetInputMethodLanguageTag(String)	尝试设置此语言的规范化 BCP-47 语言标记。

另请参阅

• OCR 示例 (Windows 10)
• 全球化首选项示例 (Windows 10)