CultureInfo.GetCultureInfoByIetfLanguageTag(String) Метод

Определение

Не рекомендуется.Deprecated. Служит для получения объекта CultureInfo, доступного только для чтения, который имеет языковые характеристики, указываемые определенным языковым тегом RFC 4646.Retrieves a read-only CultureInfo object having linguistic characteristics that are identified by the specified RFC 4646 language tag.

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.The name of a language as specified by the RFC 4646 standard.

Возвраты

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

Исключения

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

name не соответствует поддерживаемому языку и региональным параметрам.name does not correspond to a supported culture.

Комментарии

Примечание

Этот метод и свойство IetfLanguageTag являются устаревшими.This method and the IetfLanguageTag property are deprecated. Вместо использования этих элементов приложение должно использовать новый объект CultureInfo и вызывать свойство Name.Instead of using these elements, the application should use a new CultureInfo object and calls to the Name property. Теги и имена IETF идентичны.IETF tags and names are identical.

Стандарт RFC 4646, поддерживаемый IETF, определяет тег языка IETF, который предоставляет единообразные средства идентификации языка.The RFC 4646 standard that is maintained by the Internet Engineering Task Force (IETF) defines an IETF language tag, which provides a uniform means of identifying a language. Формат тега языка IETF совпадает с именем языка и региональных параметров, возвращаемого свойством Name, но не определяет уникальную культуру.The format of an IETF language tag is the same as the culture name returned by the Name property, but does not identify a culture uniquely. Разные языки и региональные параметры совместно используют один и тот же тег языка IETF, если эти культуры имеют одинаковые лингвистические характеристики.Different cultures share the same IETF language tag if those cultures have identical linguistic characteristics. Лингвистические характеристики языка и региональных параметров содержатся в объекте TextInfo, связанном с объектом CultureInfo.The linguistic characteristics of a culture are contained in the TextInfo object associated with a CultureInfo object.

Тег языка IETF состоит из обязательного идентификатора языка, необязательного идентификатора скрипта и необязательного идентификатора региона.An IETF language tag consists of a mandatory language identifier, an optional script identifier, and an optional region identifier.

Приложения должны использовать полученный язык и региональные параметры для управления задачами конкретного языка, такими как управление проверкой орфографии или грамматики.Your applications should use the retrieved culture to control language-specific tasks, such as managing a spelling or grammar checker. Приложения не должны использовать полученный язык и региональные параметры для управления задачами, зависящими от языка и региональных параметров, например для сортировки текста или форматирования дат и времени.Applications should not use the retrieved culture to control culture-specific tasks, such as sorting text or formatting times and dates.

Дополнительные сведения см. в разделе RFC 4646, "Теги для идентификации языков" и последнем черном стандарте Draft-Phillips-langtags-05. txt, по адресу https://go.microsoft.com/fwlink/?LinkId=100231.For more information, see RFC 4646, "Tags for Identifying Languages," and the most recent draft standard, Draft-phillips-langtags-05.txt, at https://go.microsoft.com/fwlink/?LinkId=100231.

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

.NET Framework 3,5.NET Framework 3.5 и более ранние версии вызовут ArgumentException, если name не соответствует имени поддерживаемого языка и региональных параметров.The .NET Framework 3,5.NET Framework 3.5 and earlier versions throw an ArgumentException if name does not correspond to the name of a supported culture. Начиная с .NET Framework 4.NET Framework 4этот метод создает исключение CultureNotFoundException.Starting with the .NET Framework 4.NET Framework 4, this method throws a CultureNotFoundException.

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

Дополнительно