CultureInfo.GetCultureInfoByIetfLanguageTag(String) Método

Definición

Espacio de nombres:

System.Globalization

Ensamblado:

System.Runtime.dll

Source:

CultureInfo.cs

Desusado. Recupera un objeto CultureInfo de solo lectura cuyas características lingüísticas se identifican por la etiqueta de idioma RFC 4646 especificada.

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

Parámetros

name

String

Nombre de un idioma especificado por el estándar RFC 4646.

Devoluciones

CultureInfo

Un objeto CultureInfo de solo lectura.

Excepciones

ArgumentNullException

name es null.

CultureNotFoundException

name no corresponde a una referencia cultural admitida.

Comentarios

Nota:

Este método y la IetfLanguageTag propiedad están en desuso. En lugar de usar estas API, se recomienda usar los CultureInfo constructores , CultureInfo.GetCultureInfoy la Name propiedad . Las etiquetas y los nombres de IETF son idénticos.

El estándar RFC 4646 que mantiene el Grupo de Tareas de Ingeniería de Internet (IETF) define una etiqueta de idioma IETF, que proporciona un medio uniforme para identificar un idioma. El formato de una etiqueta de idioma IETF es el mismo que el nombre de referencia cultural devuelto por la Name propiedad , pero no identifica una referencia cultural de forma única. Las distintas referencias culturales comparten la misma etiqueta de idioma IETF si esas referencias culturales tienen características lingüísticas idénticas. Las características lingüísticas de una referencia cultural se encuentran en el TextInfo objeto asociado a un CultureInfo objeto .

Una etiqueta de idioma IETF consta de un identificador de idioma obligatorio, un identificador de script opcional y un identificador de región opcional.

Las aplicaciones deben usar la referencia cultural recuperada para controlar tareas específicas del idioma, como administrar un corrector ortográfico o gramatical. Las aplicaciones no deben usar la referencia cultural recuperada para controlar tareas específicas de la referencia cultural, como ordenar texto o dar formato a horas y fechas.

Para obtener más información, vea RFC 4646 : "Etiquetas para identificar idiomas.

Notas a los autores de las llamadas

.NET Framework 3.5 y versiones anteriores inician una ArgumentException excepción si name no corresponde al nombre de una referencia cultural admitida. A partir de .NET Framework 4, este método produce una CultureNotFoundExceptionexcepción .

Consulte también

• TextInfo
• CultureAndRegionInfoBuilder
• ClearCachedData()