CultureInfo.GetCultureInfoByIetfLanguageTag(String) Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Globalization
Zestaw:
System.Runtime.dll
Zestaw:
mscorlib.dll
Zestaw:
netstandard.dll
Źródło:
CultureInfo.cs
Źródło:
CultureInfo.cs
Źródło:
CultureInfo.cs

Przestarzałe. Pobiera obiekt tylko CultureInfo do odczytu o cechach językowych, które są identyfikowane przez określony tag języka RFC 4646.

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

Parametry

name
String

Nazwa języka określona przez standard RFC 4646.

Zwraca

CultureInfo

Obiekt tylko do CultureInfo odczytu.

Wyjątki

ArgumentNullException

name ma wartość null.

CultureNotFoundException

name nie odpowiada obsługiwanej kulturze.

Uwagi

Uwaga

Ta metoda i IetfLanguageTag właściwość są przestarzałe. Zamiast korzystać z tych interfejsów API, zalecamy używanie CultureInfo konstruktorów , CultureInfo.GetCultureInfoi Name właściwości . Tagi i nazwy IETF są identyczne.

Standard RFC 4646, który jest obsługiwany przez Internet Engineering Task Force (IETF) definiuje tag języka IETF, który zapewnia jednolity sposób identyfikacji języka. Format tagu języka IETF jest taki sam jak nazwa kultury zwracana przez Name właściwość, ale nie identyfikuje kultury unikatowo. Różne kultury mają ten sam tag języka IETF, jeśli te kultury mają identyczne cechy językowe. Cechy językowe kultury są zawarte w TextInfo obiekcie skojarzonym z obiektem CultureInfo .

Tag języka IETF składa się z obowiązkowego identyfikatora języka, opcjonalnego identyfikatora skryptu i opcjonalnego identyfikatora regionu.

Aplikacje powinny używać pobranej kultury do kontrolowania zadań specyficznych dla języka, takich jak zarządzanie sprawdzaniem pisowni lub gramatyki. Aplikacje nie powinny używać pobranej kultury do kontrolowania zadań specyficznych dla kultury, takich jak sortowanie tekstu lub godziny formatowania i daty.

Aby uzyskać więcej informacji, zobacz RFC 4646 — "Tagi identyfikacji języków.

Uwagi dotyczące wywoływania

.NET Framework 3.5 i wcześniejszych wersjach zgłaszają wyjątek ArgumentException , jeśli name nie odpowiada nazwie obsługiwanej kultury. Począwszy od .NET Framework 4, ta metoda zgłasza błąd CultureNotFoundException.

Dotyczy

Zobacz też