CultureInfo.GetCultureInfoByIetfLanguageTag(String) Метод

  • Ссылка

Определение

Пространство имен:
System.Globalization
Сборка:
System.Runtime.dll
Сборка:
mscorlib.dll
Сборка:
netstandard.dll
Исходный код:
CultureInfo.cs
Исходный код:
CultureInfo.cs
Исходный код:
CultureInfo.cs

Не рекомендуется. Служит для получения объекта 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.CultureInfo
Public Shared Function GetCultureInfoByIetfLanguageTag (name As String) As CultureInfo

Параметры

name
String

Имя языка по стандарту RFC 4646.

Возвращаемое значение

CultureInfo

Объект CultureInfo, доступный только для чтения.

Исключения

ArgumentNullException

Параметр name имеет значение null.

CultureNotFoundException

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.

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

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