Partilhar via


CultureInfo.GetCultureInfoByIetfLanguageTag(String) Método

Definição

Preterido. Recupera um objeto CultureInfo somente leitura tendo características linguísticas que são identificadas pela marca 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

O nome de uma linguagem conforme especificado pelo padrão RFC 4646.

Retornos

Um objeto somente leitura de CultureInfo .

Exceções

name é nulo.

name não corresponde a uma cultura com suporte.

Comentários

Observação

Esse método e a IetfLanguageTag propriedade foram preteridos. Em vez de usar essas APIs, é recomendável usar os CultureInfo construtores , CultureInfo.GetCultureInfoe a Name propriedade . Marcas e nomes IETF são idênticos.

O padrão RFC 4646 mantido pela IETF (Internet Engineering Task Force) define uma marca de idioma IETF, que fornece um meio uniforme de identificar um idioma. O formato de uma marca de idioma IETF é o mesmo que o nome da cultura retornado pela Name propriedade , mas não identifica uma cultura exclusivamente. Culturas diferentes compartilharão a mesma marca de idioma IETF se essas culturas tiverem características linguísticas idênticas. As características linguísticas de uma cultura estão contidas no objeto associado a TextInfo um CultureInfo objeto .

Uma marca de idioma IETF consiste em um identificador de idioma obrigatório, um identificador de script opcional e um identificador de região opcional.

Seus aplicativos devem usar a cultura recuperada para controlar tarefas específicas da linguagem, como gerenciar um verificador ortográfico ou gramatical. Os aplicativos não devem usar a cultura recuperada para controlar tarefas específicas da cultura, como classificar texto ou formatar datas e horas.

Para obter mais informações, consulte RFC 4646 – "Marcas para identificar idiomas.

Notas aos Chamadores

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

Aplica-se a

Confira também