CultureInfo.GetCultureInfoByIetfLanguageTag(String) Método

Referência

Definição

Namespace:: System.Globalization

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

Assembly:: mscorlib.dll

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.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

CultureInfo

Um objeto somente leitura de CultureInfo .

Exceções

ArgumentNullException

name é nulo.

CultureNotFoundException

name não corresponde a uma cultura com suporte.

Comentários

Observação

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

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

Uma marca de linguagem 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 de idioma, 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 classificação de texto ou formatação e datas.

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

Notas aos Chamadores

.NET Framework 3,5 e versões anteriores lançam um ArgumentException se não name corresponde ao nome de uma cultura com suporte. a partir do .NET Framework 4, esse método gera um CultureNotFoundException .

Aplica-se a