CultureInfo.GetCultureInfoByIetfLanguageTag(String) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Не рекомендуется. Служит для получения объекта CultureInfo, доступного только для чтения, который имеет языковые характеристики, указываемые определенным языковым тегом RFC 4646.
public:
static System::Globalization::CultureInfo ^ GetCultureInfoByIetfLanguageTag(System::String ^ name);public static System.Globalization.CultureInfo GetCultureInfoByIetfLanguageTag (string name);static member GetCultureInfoByIetfLanguageTag : string -> System.Globalization.CultureInfoPublic Shared Function GetCultureInfoByIetfLanguageTag (name As String) As CultureInfoПараметры
- name
- String
Имя языка по стандарту RFC 4646.
Возвращаемое значение
Объект CultureInfo, доступный только для чтения.
Исключения
Параметр name имеет значение null.
name не соответствует поддерживаемому языку и региональным параметрам.
Комментарии
Примечание
Этот метод и IetfLanguageTag свойство являются устаревшими. Вместо использования этих API рекомендуется использовать CultureInfo конструкторы , CultureInfo.GetCultureInfoи Name свойство . Теги и имена IETF идентичны.
Стандарт RFC 4646, поддерживаемый Целевой группой интернет-инженеров (IETF), определяет тег языка IETF, который предоставляет единообразные средства идентификации языка. Формат тега языка IETF совпадает с именем языка и региональных параметров, возвращаемым свойством Name , но не определяет язык и региональные параметры уникальным образом. Разные языки и региональные параметры используют один и тот же тег языка IETF, если они имеют одинаковые лингвистические характеристики. Лингвистические характеристики языка и региональных параметров содержатся в объекте, TextInfo связанном CultureInfo с объектом .
Тег языка IETF состоит из обязательного идентификатора языка, необязательного идентификатора скрипта и необязательного идентификатора региона.
Приложения должны использовать полученные язык и региональные параметры для управления языковыми задачами, такими как управление орфографией или проверкой грамматики. Приложения не должны использовать полученные язык и региональные параметры для управления конкретными задачами, такими как сортировка текста или форматирование времени и дат.
Дополнительные сведения см. в статье RFC 4646 — "Теги для идентификации языков.
Примечания для тех, кто вызывает этот метод
платформа .NET Framework 3.5 и более ранних версий вызывают исключение , ArgumentException если name не соответствует имени поддерживаемого языка и региональных параметров. Начиная с платформа .NET Framework 4, этот метод вызывает исключение CultureNotFoundException.
