CultureInfo.GetCultureInfoByIetfLanguageTag(String) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
Obiekt tylko do CultureInfo odczytu.
Wyjątki
name
ma wartość null.
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.