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 bestimmten Daten für diese Kultur enthält, versucht die Plattform, eine Kultur mit Daten aus anderen Kulturen oder konstanten Werten zu erstellen.

Durch Festlegen predefinedOnly von auf true wird sichergestellt, dass eine Kultur nur erstellt wird, wenn die Plattform echte Daten für diese Kultur enthält.

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 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 eines CultureInfo Konstruktors. Die -Methode wird verwendet, um eine Kultur zu erstellen, die der vom -Parameter angegebenen name ähnelt, jedoch mit unterschiedlichen Sortier- und Groß-/Kleinschreibungsregeln.

Wenn name oder der Name der altName aktuellen Kultur ist, spiegeln die zurückgegebenen Objekte 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 das Durch die invariante Kultur angegebene Schreibsystem und vergleichsregeln.

Hinweise für Aufrufer

.NET Framework 3.5 und früheren Versionen wird ArgumentException ausgelöst, 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 am Windows 7 oder höher ausgeführt werden, versucht die Methode, ein Objekt abzurufen, CultureInfo dessen Bezeichner name aus dem Betriebssystem stammt. Wenn das Betriebssystem diese Kultur nicht unterstützt und name wenn nicht der Name einer ergänzenden Kultur oder Ersetzungskultur ist, löst die Methode eine CultureNotFoundException Ausnahme 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 Objekt abzurufen, CultureInfo dessen Bezeichner name aus dem Betriebssystem stammt. Wenn das Betriebssystem diese Kultur nicht unterstützt und name wenn nicht der Name einer ergänzenden Kultur oder Ersetzungskultur ist, löst die Methode eine CultureNotFoundException Ausnahme 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(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 verwenden, da Anstelle von GetCultureInfo(String) LCIDs Locale-Namen verwendet werden sollten. Für benutzerdefinierte Locales ist der Name des Locale erforderlich.

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

Hinweise für Aufrufer

.NET Framework 3.5 und frühere Versionen eine auslösen, ArgumentException 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 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, löst die Methode eine CultureInfo culture 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(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 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 ruft ein zwischengespeichertes, schreibgeschütztes Objekt CultureInfo ab. Sie bietet eine bessere Leistung als ein entsprechender Aufruf des CultureInfo.CultureInfo(String) Konstruktors.

Wenn der Name der aktuellen Kultur ist, spiegelt name das zurückgegebene Objekt keine CultureInfo Benutzerüberschreibungen wider. Dadurch eignet sich die -Methode für Serveranwendungen oder -tools, die kein echtes Benutzerkonto im 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üheren Versionen wird ArgumentException ausgelöst, 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 am Windows 7 oder höher ausgeführt werden, versucht die Methode, ein -Objekt abzurufen, CultureInfo dessen Bezeichner name aus dem Betriebssystem stammt. Wenn das Betriebssystem diese Kultur nicht unterstützt und name wenn nicht der Name einer ergänzenden Kultur oder Ersetzungskultur ist, 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