CultureInfo.GetCultureInfo Methode

Definition

Ruft eine zwischengespeicherte und schreibgeschützte Instanz einer Kultur ab.

Überlädt

GetCultureInfo(String, Boolean)

Ruft eine zwischengespeicherte und schreibgeschützte Instanz einer Kultur ab.

GetCultureInfo(String, String)

Ruft eine zwischengespeicherte und schreibgeschützte Instanz einer Kultur ab. Mit Parametern wird eine Kultur angegeben, die mit dem TextInfo-Objekt und dem CompareInfo-Objekt initialisiert wird, die wiederum von einer anderen Kultur angegeben werden.

GetCultureInfo(Int32)

Ruft eine zwischengespeicherte und schreibgeschützte Instanz einer Kultur mithilfe des angegebenen Kulturbezeichners ab.

GetCultureInfo(String)

Ruft eine zwischengespeicherte und schreibgeschützte Instanz einer Kultur mithilfe des angegebenen Kulturnamens ab.

GetCultureInfo(String, Boolean)

Ruft eine zwischengespeicherte und schreibgeschützte Instanz einer Kultur ab.

public:
 static System::Globalization::CultureInfo ^ GetCultureInfo(System::String ^ name, bool predefinedOnly);
public static System.Globalization.CultureInfo GetCultureInfo (string name, bool predefinedOnly);
static member GetCultureInfo : string * bool -> System.Globalization.CultureInfo
Public Shared Function GetCultureInfo (name As String, predefinedOnly As Boolean) As CultureInfo

Parameter

name
String

Der Name einer Kultur. Es wird nicht zwischen Groß- und Kleinschreibung unterschieden.

predefinedOnly
Boolean

true, wenn angefordert wird, eine Instanz einer Kultur zu erstellen, die der Plattform bekannt ist. false, wenn es in Ordnung ist, eine fertige Kultur auch dann abzurufen, wenn die Plattform keine Daten für sie enthält.

Gibt zurück

CultureInfo

Eine schreibgeschützte Instanz einer Kultur.

Hinweise

Wenn sie versuchen, eine Kultur zu erstellen, und die zugrunde liegende Plattform (Windows NLS oder ICU) keine spezifischen Daten für diese Kultur enthält, versucht die Plattform standardmäßig, eine Kultur mit Daten aus anderen Kulturen oder einigen konstanten Werten zu erstellen.

Wenn Sie auf festlegen, wird sichergestellt, dass eine Kultur nur erstellt wird, predefinedOnly wenn die Plattform über echte Daten für diese Kultur true verfügt.

Gilt für

GetCultureInfo(String, String)

Ruft eine zwischengespeicherte und schreibgeschützte Instanz einer Kultur ab. Mit Parametern wird eine Kultur angegeben, die mit dem TextInfo-Objekt und dem CompareInfo-Objekt initialisiert wird, die wiederum von einer anderen Kultur angegeben werden.

public:
 static System::Globalization::CultureInfo ^ GetCultureInfo(System::String ^ name, System::String ^ altName);
public static System.Globalization.CultureInfo GetCultureInfo (string name, string altName);
static member GetCultureInfo : string * string -> System.Globalization.CultureInfo
Public Shared Function GetCultureInfo (name As String, altName As String) As CultureInfo

Parameter

name
String

Der Name einer Kultur. Bei name wird nicht zwischen Groß- und Kleinschreibung unterschieden.

altName
String

Der Name einer Kultur, die das TextInfo-Objekt und das CompareInfo-Objekt liefert, mit denen name initialisiert wird. Bei altName wird nicht zwischen Groß- und Kleinschreibung unterschieden.

Gibt zurück

CultureInfo

Ein schreibgeschütztes CultureInfo-Objekt.

Ausnahmen

name oder altName ist NULL.

name oder altName gibt eine Kultur an, die nicht unterstützt wird. Weitere Informationen finden Sie im Abschnitt „Hinweise zu Aufrufern“.

Hinweise

Eine Liste der vordefinierten Kulturnamen auf Windows-Systemen finden Sie in der Tagspalte Sprache in der Liste der von Windows . Kulturnamen befolgen den von BCP 47 definierten Standard. Darüber hinaus kann ab Windows 10 name ein beliebiges gültiges BCP-47-Sprachtag sein.

Die GetCultureInfo -Methode erhält ein zwischengespeichertes, schreibgeschütztes CultureInfo Objekt. Sie bietet eine bessere Leistung als ein entsprechender Aufruf eines CultureInfo Konstruktors. Die -Methode wird verwendet, um eine Kultur zu erstellen, die der durch den -Parameter angegebenen ähnelt, jedoch mit name unterschiedlichen Sortierungs- und Casingregeln.

Wenn oder der Name der aktuellen Kultur ist, spiegeln die zurückgegebenen Objekte name altName keine Benutzerüberschreibungen wider. Wenn name String.Empty ist, gibt die Methode die invariante Kultur zurück. Dies entspricht dem Abrufen des Werts der InvariantCulture -Eigenschaft. Wenn altName String.Empty ist, verwendet die -Methode die Schreibsystem- und Vergleichsregeln, die von der invarianten Kultur angegeben werden.

Hinweise für Aufrufer

.NET Framework 3.5 und frühere Versionen eine auslösen, ArgumentException wenn name oder kein altName gültiger Kulturname ist. Ab .NET Framework 4 löst diese Methode eine CultureNotFoundException aus. Beginnend mit Apps, die unter .NET Framework 4 oder höher auf Windows 7 oder höher ausgeführt werden, versucht die Methode, ein Objekt abzurufen, dessen Bezeichner vom Betriebssystem ist. Wenn das Betriebssystem diese Kultur nicht unterstützt und nicht der Name einer ergänzenden kultur oder Ersetzungskultur ist, löst die Methode eine CultureInfo name Ausnahme name CultureNotFoundException aus. Beginnend mit Apps, die unter .NET Framework 4 oder höher auf Windows 7 oder höher ausgeführt werden, versucht die Methode, ein Objekt abzurufen, dessen Bezeichner vom Betriebssystem ist. Wenn das Betriebssystem diese Kultur nicht unterstützt und nicht der Name einer ergänzenden kultur oder Ersetzungskultur ist, löst die Methode eine CultureInfo name Ausnahme name CultureNotFoundException aus.

In .NET 6 und höher wird eine ausgelöst, wenn die App in einer Umgebung ausgeführt wird, in der der globalisierungsinvariante Modus aktiviert ist, z. B. einige Docker-Container und eine andere Kultur als die invariante Kultur CultureNotFoundException angegeben ist.

Siehe auch

Gilt für

GetCultureInfo(Int32)

Ruft eine zwischengespeicherte und schreibgeschützte Instanz einer Kultur mithilfe des angegebenen Kulturbezeichners ab.

public:
 static System::Globalization::CultureInfo ^ GetCultureInfo(int culture);
public static System.Globalization.CultureInfo GetCultureInfo (int culture);
static member GetCultureInfo : int -> System.Globalization.CultureInfo
Public Shared Function GetCultureInfo (culture As Integer) As CultureInfo

Parameter

culture
Int32

Ein Gebietsschemabezeichner (LCID).

Gibt zurück

CultureInfo

Ein schreibgeschütztes CultureInfo-Objekt.

Ausnahmen

culture ist kleiner als Null.

culture gibt eine Kultur an, die nicht unterstützt wird. Weitere Informationen finden Sie im Abschnitt "Hinweise zu Aufrufern".

Hinweise

Es wird empfohlen, die Zeichenfolgenüberladung dieser Methode ( ) zu GetCultureInfo(String) verwenden, da Gebietsschemanamen anstelle von LCIDs verwendet werden sollten. Für benutzerdefinierte Gebietsschemas ist der Gebietsschemaname erforderlich.

Wenn culture der Gebietsschemabezeichner der aktuellen Kultur ist, spiegelt das zurückgegebene CultureInfo Objekt keine Benutzerüberschreibungen wider.

Hinweise für Aufrufer

.NET Framework 3.5 und früheren Versionen wird ArgumentException ausgelöst, wenn culture kein gültiger Kulturbezeichner ist. Ab .NET Framework 4 löst diese Methode eine CultureNotFoundException aus. Beginnend mit Apps, die unter .NET Framework 4 oder höher am Windows 7 oder höher ausgeführt werden, versucht die Methode, ein CultureInfo -Objekt abzurufen, dessen Bezeichner culture aus dem Betriebssystem stammt. Wenn das Betriebssystem diese Kultur nicht unterstützt, löst die -Methode eine CultureNotFoundException aus.

In .NET 6 und höher wird eine CultureNotFoundException ausgelöst, wenn die App in einer Umgebung ausgeführt wird, in der der globalisierungsinvariante Modus aktiviert ist, z. B. einige Docker-Container, und eine andere Kultur als die invariante Kultur angegeben wird.

Siehe auch

Gilt für

GetCultureInfo(String)

Ruft eine zwischengespeicherte und schreibgeschützte Instanz einer Kultur mithilfe des angegebenen Kulturnamens ab.

public:
 static System::Globalization::CultureInfo ^ GetCultureInfo(System::String ^ name);
public static System.Globalization.CultureInfo GetCultureInfo (string name);
static member GetCultureInfo : string -> System.Globalization.CultureInfo
Public Shared Function GetCultureInfo (name As String) As CultureInfo

Parameter

name
String

Der Name einer Kultur. Bei name wird nicht zwischen Groß- und Kleinschreibung unterschieden.

Gibt zurück

CultureInfo

Ein schreibgeschütztes CultureInfo-Objekt.

Ausnahmen

name ist NULL.

name gibt eine Kultur an, die nicht unterstützt wird. Weitere Informationen finden Sie im Abschnitt „Hinweise zu Aufrufern“.

Hinweise

Eine Liste vordefinierter Kulturnamen auf Windows Systemen finden Sie in der Spalte Sprachtag in der Liste der Sprach-/Regionsnamen,die von Windows unterstützt werden. Kulturnamen befolgen den von BCP 47 definierten Standard. Darüber hinaus kann ab Windows 10 name ein beliebiges gültiges BCP-47-Sprachtag sein.

Die GetCultureInfo -Methode ruft ein zwischengespeichertes, schreibgeschütztes CultureInfo Objekt ab. Sie bietet eine bessere Leistung als ein entsprechender Aufruf des CultureInfo.CultureInfo(String) Konstruktors.

Wenn name der Name der aktuellen Kultur ist, spiegelt das CultureInfo zurückgegebene Objekt keine Benutzerüberschreibungen wider. Dies macht die Methode für Serveranwendungen oder Tools geeignet, die kein echtes Benutzerkonto auf dem System haben und mehrere Kulturen effizient laden müssen.

Wenn name String.Empty ist, gibt die Methode die invariante Kultur zurück. Dies entspricht dem Abrufen des Werts der InvariantCulture -Eigenschaft.

Hinweise für Aufrufer

.NET Framework 3.5 und frühere Versionen eine auslösen, ArgumentException wenn name kein gültiger Kulturname ist. Ab .NET Framework 4 löst diese Methode eine CultureNotFoundException aus. Beginnend mit Apps, die unter .NET Framework 4 oder höher auf Windows 7 oder höher ausgeführt werden, versucht die Methode, ein Objekt abzurufen, dessen Bezeichner vom Betriebssystem ist. Wenn das Betriebssystem diese Kultur nicht unterstützt und nicht der Name einer ergänzenden kultur oder CultureInfo Ersetzungskultur ist, löst die Methode eine name name CultureNotFoundException aus.

In .NET 6 und höher wird eine ausgelöst, wenn die App in einer Umgebung ausgeführt wird, in der der globalisierungsinvariante Modus aktiviert ist, z. B. einige Docker-Container und eine andere Kultur als die invariante Kultur CultureNotFoundException angegeben ist.

Siehe auch

Gilt für