CultureInfo.GetCultureInfoByIetfLanguageTag(String) Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Globalization
Zestaw:
System.Runtime.dll
Zestaw:
mscorlib.dll
Zestaw:
netstandard.dll
Source:
CultureInfo.cs
Source:
CultureInfo.cs
Source:
CultureInfo.cs

Przestarzałe. Pobiera obiekt tylko do CultureInfo odczytu o cechach językowych identyfikowanych 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ślonego 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życie 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 identyfikowania języka. Format tagu języka IETF jest taki sam jak nazwa kultury zwrócona 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 znajdują się 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 formatowanie godzin i dat.

Aby uzyskać więcej informacji, zobacz RFC 4646 — "Tagi identyfikujące języki.

Uwagi dotyczące wywoływania

.NET Framework 3.5 i starsze wersje zgłaszają wartość 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ż