CultureInfo.GetCultureInfoByIetfLanguageTag(String) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.CultureInfoPublic Shared Function GetCultureInfoByIetfLanguageTag (name As String) As CultureInfoParâ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.
