Linguagem

CultureInfo.GetCultureInfoByIetfLanguageTag(String) Método

Definição

Deprecated. Recupera um objeto somente CultureInfo de leitura com características linguísticas identificadas pela etiqueta linguística 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

O nome de uma linguagem conforme especificado pela norma RFC 4646.

Devoluções

Um objeto só CultureInfo de leitura.

Exceções

name é null.

name não corresponde a uma cultura apoiada.

Observações

Note

Este método e a IetfLanguageTag propriedade estão obsoletos. Em vez de usar estas APIs, recomendamos usar os CultureInfo construtores, CultureInfo.GetCultureInfo, e a Name propriedade. As etiquetas e nomes do IETF são idênticos.

A norma RFC 4646, mantida pela Internet Engineering Task Force (IETF), define uma etiqueta de linguagem IETF, que fornece um meio uniforme de identificar uma linguagem. O formato de uma etiqueta de língua IETF é o mesmo que o nome da cultura devolvido pela Name propriedade, mas não identifica uma cultura de forma única. Diferentes culturas partilham a mesma etiqueta linguística do IETF se essas culturas tiverem características linguísticas idênticas. As características linguísticas de uma cultura estão contidas no TextInfo objeto associado a esse CultureInfo objeto.

Uma etiqueta de linguagem IETF consiste num identificador de língua obrigatório, um identificador de script opcional e um identificador de região opcional.

As suas aplicações devem usar a cultura recuperada para controlar tarefas específicas da língua, como gerir um corretor ortográfico ou gramatical. As aplicações não devem usar a cultura recuperada para controlar tarefas específicas da cultura, como ordenar texto ou formatar tempos e datas.

Para mais informações, consulte RFC 4646 - "Etiquetas para Identificação de Línguas.

Notas para Chamadores

.NET Framework 3.5 e versões anteriores lançam um ArgumentException se name não corresponder ao nome de uma cultura suportada. Começando com .NET Framework 4, este método gera um CultureNotFoundException.

Aplica-se a

Ver também