Language Класс

Определение

Класс, предоставляющий сведения, связанные с тегами языка BCP-47 , такие как имя языка и скрипт.

public ref class Language sealed
/// [Windows.Foundation.Metadata.Activatable(Windows.Globalization.ILanguageFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [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 Language final
/// [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.Activatable(typeof(Windows.Globalization.ILanguageFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[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 sealed class Language
[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
Атрибуты

Требования к 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:

Языковые теги поддерживают расширения Юникода "ca-" и "nu-". (См . раздел Определения ключа и типа Юникода.) Обратите внимание, что эти расширения могут влиять на календарь, используемый объектами Calendar.

Журнал версий

Версия Windows Версия пакета SDK Добавленная стоимость
1803 17134 LayoutDirection
2004 19041 Сокращенное имя
2004 19041 GetMuiCompatibleLanguageListFromLanguageTags

Конструкторы

Language(String)

Создает объект Language .

Свойства

AbbreviatedName

Возвращает трехбуквенное сокращение тега языка BCP-47. Например, "en-US" преобразуется в "eng".

CurrentInputMethodLanguageTag

Возвращает тег языка BCP-47 для текущей раскладки клавиатуры или редактора метода ввода (IME).

DisplayName

Возвращает локализованную строку, подходящую для отображения пользователю для идентификации языка.

LanguageTag

Возвращает нормализованный тег языка BCP-47 для этого языка.

LayoutDirection

Возвращает направление макета содержимого (для текста и элементов пользовательского интерфейса), наиболее подходящее для языка.

NativeName

Возвращает имя языка в самом языке.

Script

Возвращает четырехбуквенный код скрипта ISO 15924 языка.

Методы

GetExtensionSubtags(String)

Извлекает вектор подтегов расширений на текущем языке для заданного расширения, определяемого одноэлементным.

GetMuiCompatibleLanguageListFromLanguageTags(IIterable<String>)

Извлекает набор тегов многоязычного пользовательского интерфейса (MUI), производных от одного или нескольких тегов языка BCP-47.

IsWellFormed(String)

Определяет, правильно ли сформирован тег языка BCP-47 .

TrySetInputMethodLanguageTag(String)

Пытается задать для этого языка нормализованный тег языка BCP-47 .

Применяется к

См. также раздел