CultureInfo.GetCultureInfoByIetfLanguageTag(String) Метод

Определение

Пространство имен:
System.Globalization
Сборка:
mscorlib.dll
Сборка:
netstandard.dll

Deprecated. Извлекает объект только для 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 не соответствует поддерживаемому языку и региональным параметрам.

Комментарии

Note

Этот метод и IetfLanguageTag свойство устарели. Вместо использования этих API рекомендуется использовать CultureInfo конструкторы CultureInfo.GetCultureInfoи Name свойство. Теги и имена IETF идентичны.

Стандарт RFC 4646, поддерживаемый IETF (IETF), определяет тег языка IETF, который предоставляет универсальные средства идентификации языка. Формат тега языка IETF совпадает с именем языка и региональных параметров, возвращаемым Name свойством, но не определяет язык и региональные параметры уникально. Разные региональные параметры используют один и тот же тег языка IETF, если эти региональные параметры имеют идентичные лингвистические характеристики. Лингвистические характеристики языка и региональных параметров содержатся в объекте, связанном TextInfoCultureInfo с объектом.

Тег языка IETF состоит из обязательного идентификатора языка, необязательного идентификатора скрипта и необязательного идентификатора региона.

Приложения должны использовать извлеченные язык и региональные параметры для управления задачами, зависящими от языка, такими как управление орфографическим или грамматической проверкой. Приложения не должны использовать полученный язык и региональные параметры для управления задачами, зависящими от языка и региональных параметров, такими как сортировка текста или время форматирования и даты.

Дополнительные сведения см. в разделе RFC 4646 — "Теги для идентификации языков.

Примечания для тех, кто вызывает этот метод

.NET Framework 3.5 и более ранние версии вызывают ArgumentException исключение, если name не соответствует имени поддерживаемого языка и региональных параметров. Начиная с .NET Framework 4, этот метод создает CultureNotFoundExceptionисключение.

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

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