CultureInfo.GetCultureInfo Methode

  • Referenz

Definition

Namespace:
System.Globalization
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

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

Ein schreibgeschützter instance 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, eine Kultur mit Daten aus anderen Kulturen oder einigen konstanten Werten zu erstellen.

Wenn Sie auf festlegen predefinedOnly , true wird sichergestellt, dass eine Kultur nur erstellt wird, wenn die Plattform über echte Daten für diese Kultur 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

ArgumentNullException

name oder altName ist NULL.

CultureNotFoundException

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 Spalte Sprachtag in der Liste der von Windows unterstützten Sprach-/Regionsnamen. 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. Es bietet eine bessere Leistung als ein entsprechender Aufruf eines CultureInfo Konstruktors. Die -Methode wird verwendet, um eine Kultur zu erstellen, die der durch den name -Parameter angegebenen ähnlich ist, aber mit unterschiedlichen Sortier- und Groß-/Kleinschreibungsregeln.

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

Hinweise für Aufrufer

.NET Framework 3.5 und früheren Versionen lösen einen ausArgumentException, wenn name oder altName kein gültiger Kulturname ist. Ab .NET Framework 4 löst diese Methode einen ausCultureNotFoundException. Beginnend mit Apps, die unter .NET Framework 4 oder höher unter Windows 7 oder höher ausgeführt werden, versucht die Methode, ein CultureInfo Objekt abzurufen, dessen Bezeichner vom Betriebssystem stammtname. Wenn das Betriebssystem diese Kultur nicht unterstützt, und wenn name nicht der Name einer Ergänzenden oder Ersatzkultur ist, löst die Methode eine Ausnahme ausCultureNotFoundException.

Unter .NET 6 und höheren Versionen wird ein 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.

Weitere Informationen

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

ArgumentOutOfRangeException

culture ist kleiner als Null.

CultureNotFoundException

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 (GetCultureInfo(String)) zu 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 Version 3.5 und früheren Versionen wird ausgelöst, ArgumentException wenn culture kein gültiger Kulturbezeichner ist. Ab .NET Framework 4 löst diese Methode einen ausCultureNotFoundException. Beginnend mit Apps, die unter .NET Framework 4 oder höher unter Windows 7 oder höher ausgeführt werden, versucht die Methode, ein CultureInfo Objekt abzurufen, dessen Bezeichner vom Betriebssystem stammtculture. Wenn das Betriebssystem diese Kultur nicht unterstützt, löst die -Methode einen ausCultureNotFoundException.

Unter .NET 6 und höheren Versionen wird ein 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.

Weitere Informationen

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

ArgumentNullException

name ist NULL.

CultureNotFoundException

name 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 Spalte Sprachtag in der Liste der von Windows unterstützten Sprach-/Regionsnamen. 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. Es bietet eine bessere Leistung als ein entsprechender Aufruf des CultureInfo.CultureInfo(String) Konstruktors.

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

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

Hinweise für Aufrufer

.NET Framework Version 3.5 und früheren Versionen wird ausgelöst, ArgumentException wenn name kein gültiger Kulturname ist. Ab .NET Framework 4 löst diese Methode einen ausCultureNotFoundException. Beginnend mit Apps, die unter .NET Framework 4 oder höher unter Windows 7 oder höher ausgeführt werden, versucht die Methode, ein CultureInfo Objekt abzurufen, dessen Bezeichner vom Betriebssystem stammtname. Wenn das Betriebssystem diese Kultur nicht unterstützt, und wenn name nicht der Name einer Ergänzenden oder Ersatzkultur ist, löst die Methode einen ausCultureNotFoundException.

Unter .NET 6 und höheren Versionen wird ein 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.

Weitere Informationen

Gilt für: