CultureInfo.GetCultureInfoByIetfLanguageTag(String) Méthode

  • Référence

Définition

Espace de noms:
System.Globalization
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Source:
CultureInfo.cs
Source:
CultureInfo.cs
Source:
CultureInfo.cs

Obsolète. Récupère un objet CultureInfo en lecture seule ayant des caractéristiques linguistiques identifiées par la balise de langue RFC 4646 spécifiée.

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

Paramètres

name
String

Nom d'une langue tel qu'il est spécifié par la norme RFC 4646.

Retours

CultureInfo

Objet CultureInfo en lecture seule.

Exceptions

ArgumentNullException

name a la valeur null.

CultureNotFoundException

name ne correspond pas à une culture prise en charge.

Remarques

Notes

Cette méthode et la IetfLanguageTag propriété sont déconseillées. Au lieu d’utiliser ces API, nous vous recommandons d’utiliser les CultureInfo constructeurs , CultureInfo.GetCultureInfoet la Name propriété . Les balises et les noms IETF sont identiques.

La norme RFC 4646 qui est gérée par l’Internet Engineering Task Force (IETF) définit une balise de langue IETF, qui fournit un moyen uniforme d’identifier une langue. Le format d’une balise de langue IETF est identique au nom de culture retourné par la Name propriété, mais n’identifie pas une culture de manière unique. Différentes cultures partagent la même balise de langue IETF si ces cultures ont des caractéristiques linguistiques identiques. Les caractéristiques linguistiques d’une culture sont contenues dans l’objet TextInfo associé à un CultureInfo objet .

Une balise de langue IETF se compose d’un identificateur de langue obligatoire, d’un identificateur de script facultatif et d’un identificateur de région facultatif.

Vos applications doivent utiliser la culture récupérée pour contrôler les tâches propres à la langue, telles que la gestion d’un vérificateur d’orthographe ou de grammaire. Les applications ne doivent pas utiliser la culture récupérée pour contrôler les tâches spécifiques à la culture, telles que le tri du texte ou la mise en forme des heures et des dates.

Pour plus d’informations, consultez RFC 4646 - « Balises pour l’identification des langues.

Notes pour les appelants

.NET Framework 3.5 et versions antérieures lèvent un ArgumentException si name ne correspond pas au nom d’une culture prise en charge. À compter de .NET Framework 4, cette méthode lève un CultureNotFoundException.

S’applique à

Voir aussi