CultureInfo.GetCultureInfoByIetfLanguageTag(String) Methode

Definition

Veraltet.Deprecated. Ruft ein schreibgeschütztes CultureInfo-Objekt ab, dessen linguistische Merkmale vom angegebenen RFC 4646-Sprachtag identifiziert werden.Retrieves a read-only CultureInfo object having linguistic characteristics that are identified by the specified RFC 4646 language tag.

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

Parameter

name
String

Der Name einer Sprache gemäß dem Standard RFC 4646.The name of a language as specified by the RFC 4646 standard.

Gibt zurück

Ein schreibgeschütztes CultureInfo-Objekt.A read-only CultureInfo object.

Ausnahmen

name ist NULL.name is null.

name entspricht keiner unterstützten Kultur.name does not correspond to a supported culture.

Hinweise

Hinweis

Diese Methode und die IetfLanguageTag-Eigenschaft sind veraltet.This method and the IetfLanguageTag property are deprecated. Anstatt diese Elemente zu verwenden, sollte die Anwendung ein neues CultureInfo-Objekt verwenden und die Name-Eigenschaft aufrufen.Instead of using these elements, the application should use a new CultureInfo object and calls to the Name property. IETF-Tags und-Namen sind identisch.IETF tags and names are identical.

Der von der Internet Engineering Task Force (IETF) verwaltet RFC 4646-Standard definiert ein IETF-Sprachtag, das eine einheitliche Methode zum Identifizieren einer Sprache bereitstellt.The RFC 4646 standard that is maintained by the Internet Engineering Task Force (IETF) defines an IETF language tag, which provides a uniform means of identifying a language. Das Format eines IETF-sprach Tags ist mit dem Kultur Namen identisch, der von der Name-Eigenschaft zurückgegeben wird, aber es wird keine Kultur eindeutig identifiziert.The format of an IETF language tag is the same as the culture name returned by the Name property, but does not identify a culture uniquely. Verschiedene Kulturen verwenden dasselbe IETF-Sprachtag, wenn diese Kulturen identische linguistische Merkmale aufweisen.Different cultures share the same IETF language tag if those cultures have identical linguistic characteristics. Die linguistischen Merkmale einer Kultur sind im TextInfo Objekt enthalten, das einem CultureInfo Objekt zugeordnet ist.The linguistic characteristics of a culture are contained in the TextInfo object associated with a CultureInfo object.

Ein IETF-Sprachtag besteht aus einem obligatorischen sprach Bezeichner, einer optionalen Skript Kennung und einem optionalen Bereichs Bezeichner.An IETF language tag consists of a mandatory language identifier, an optional script identifier, and an optional region identifier.

Ihre Anwendungen sollten die abgerufene Kultur verwenden, um sprachspezifische Aufgaben zu steuern, z. b. das Verwalten einer Rechtschreibprüfung oder einer Grammatik Prüfung.Your applications should use the retrieved culture to control language-specific tasks, such as managing a spelling or grammar checker. Anwendungen sollten die abgerufene Kultur nicht zum Steuern kulturspezifischer Aufgaben verwenden, wie z. b. das Sortieren von Text oder das Formatieren von Zeiten und Datumsangaben.Applications should not use the retrieved culture to control culture-specific tasks, such as sorting text or formatting times and dates.

Weitere Informationen finden Sie unter RFC 4646, "Tags für identifizierende Sprachen" und dem neuesten Entwurfs Standard, Draft-phillips-langtags-05. txt, unter https://go.microsoft.com/fwlink/?LinkId=100231.For more information, see RFC 4646, "Tags for Identifying Languages," and the most recent draft standard, Draft-phillips-langtags-05.txt, at https://go.microsoft.com/fwlink/?LinkId=100231.

Hinweise für Aufrufer

In der .NET Framework 3,5.NET Framework 3.5 und früheren Versionen wird eine ArgumentException ausgelöst, wenn name nicht dem Namen einer unterstützten Kultur entspricht.The .NET Framework 3,5.NET Framework 3.5 and earlier versions throw an ArgumentException if name does not correspond to the name of a supported culture. Beginnend mit dem .NET Framework 4.NET Framework 4löst diese Methode eine CultureNotFoundExceptionaus.Starting with the .NET Framework 4.NET Framework 4, this method throws a CultureNotFoundException.

Gilt für:

Siehe auch