CultureInfo.GetCultureInfo Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft eine zwischengespeicherte, schreibgeschützte Instanz einer Kultur ab.
Überlädt
| Name | Beschreibung |
|---|---|
| GetCultureInfo(String, Boolean) |
Ruft eine zwischengespeicherte, schreibgeschützte Instanz einer Kultur ab. |
| GetCultureInfo(String, String) |
Ruft eine zwischengespeicherte, schreibgeschützte Instanz einer Kultur ab. Parameter geben eine Kultur an, die mit den TextInfoCompareInfo durch eine andere Kultur angegebenen Objekten initialisiert wird. |
| GetCultureInfo(Int32) |
Ruft eine zwischengespeicherte, schreibgeschützte Instanz einer Kultur mithilfe des angegebenen Kulturbezeichners ab. |
| GetCultureInfo(String) |
Ruft eine zwischengespeicherte, schreibgeschützte Instanz einer Kultur mithilfe des angegebenen Kulturnamens ab. |
GetCultureInfo(String, Boolean)
- Quelle:
- CultureInfo.cs
- Quelle:
- CultureInfo.cs
- Quelle:
- CultureInfo.cs
- Quelle:
- CultureInfo.cs
- Quelle:
- CultureInfo.cs
Ruft eine zwischengespeicherte, 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.CultureInfoPublic Shared Function GetCultureInfo (name As String, predefinedOnly As Boolean) As CultureInfoParameter
- name
- String
Der Name einer Kultur. Die Groß-/Kleinschreibung wird nicht beachtet.
- predefinedOnly
- Boolean
true wenn Sie anfordern, eine Instanz einer Kultur zu erstellen, die von der Plattform bekannt ist.
false wenn es ok ist, eine made-up-Kultur zu retrepen, auch wenn die Plattform keine Daten dafür trägt.
Gibt zurück
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 zu erstellen, versucht die Plattform, eine Kultur mit Daten aus anderen Kulturen oder einigen konstanten Werten zu erstellen.
Die Einstellung predefinedOnly , um true sicherzustellen, dass eine Kultur nur erstellt wird, wenn die Plattform echte Daten für diese Kultur hat.
Gilt für:
GetCultureInfo(String, String)
- Quelle:
- CultureInfo.cs
- Quelle:
- CultureInfo.cs
- Quelle:
- CultureInfo.cs
- Quelle:
- CultureInfo.cs
- Quelle:
- CultureInfo.cs
Ruft eine zwischengespeicherte, schreibgeschützte Instanz einer Kultur ab. Parameter geben eine Kultur an, die mit den TextInfoCompareInfo durch eine andere Kultur angegebenen Objekten initialisiert wird.
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.CultureInfoPublic Shared Function GetCultureInfo (name As String, altName As String) As CultureInfoParameter
- name
- String
Der Name einer Kultur. bei name wird die Groß-/Kleinschreibung nicht beachtet.
- altName
- String
Der Name einer Kultur, die die TextInfo zum Initialisieren nameverwendeten Objekte bereitstelltCompareInfo. bei altName wird die Groß-/Kleinschreibung nicht beachtet.
Gibt zurück
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 Anrufern".
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 folgen dem 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 dem durch den name Parameter angegebenen, aber mit unterschiedlichen Sortier- und Groß-/Kleinschreibungsregeln ähnelt.
Wenn name oder altName der Name der aktuellen Kultur ist, spiegeln die zurückgegebenen Objekte keine Benutzerüberschreibungen wider. Wenn name ja String.Empty, gibt die Methode die invariante Kultur zurück. Dies entspricht dem Abrufen des Werts der InvariantCulture Eigenschaft. Wenn altName ja String.Empty, verwendet die Methode das Schreibsystem und Vergleichsregeln, die durch die invariante Kultur angegeben werden.
Hinweise für Aufrufer
.NET Framework 3.5 und frühere Versionen lösen ein ArgumentException , wenn name oder altName kein gültiger Kulturname ist. Ab .NET Framework 4 löst diese Methode ein CultureNotFoundException. 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 stammt name . Wenn das Betriebssystem diese Kultur nicht unterstützt und wenn name es sich nicht um den Namen einer ergänzenden oder ersetzungskultur handelt, löst die Methode eine CultureNotFoundException Ausnahme aus.
In .NET 6 und höheren Versionen wird ein CultureNotFoundException Fehler ausgelöst, wenn die App in einer Umgebung ausgeführt wird, in der der Globalisierungs-invariante 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)
- Quelle:
- CultureInfo.cs
- Quelle:
- CultureInfo.cs
- Quelle:
- CultureInfo.cs
- Quelle:
- CultureInfo.cs
- Quelle:
- CultureInfo.cs
Ruft eine zwischengespeicherte, 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.CultureInfoPublic Shared Function GetCultureInfo (culture As Integer) As CultureInfoParameter
- culture
- Int32
Ein Gebietsschemabezeichner (LCID).
Gibt zurück
Ein schreibgeschütztes CultureInfo Objekt.
Ausnahmen
culture ist kleiner als 0 (null).
culture Gibt eine Kultur an, die nicht unterstützt wird. Weitere Informationen finden Sie im Abschnitt "Hinweise zu Anrufer".
Hinweise
Es wird empfohlen, die Zeichenfolgenüberladung dieser Methode (GetCultureInfo(String)) zu verwenden, da Gebietsschemanamen anstelle von LCIDs verwendet werden sollen. Für benutzerdefinierte Gebietsschemas ist der Gebietsschemaname erforderlich.
Wenn culture es sich um den Gebietsschemabezeichner der aktuellen Kultur handelt, spiegelt das zurückgegebene CultureInfo Objekt keine Benutzerüberschreibungen wider.
Hinweis
LCIDs sind veraltet, und Implementierungen werden dringend empfohlen, stattdessen neuere Versionen von APIs zu verwenden, die stattdessen BCP 47 Gebietsschemanamen unterstützen. Jede LCID kann durch einen BCP 47-Gebietsschemanamen dargestellt werden, die Umgekehrte ist jedoch nicht wahr. Der LCID-Bereich ist eingeschränkt und kann nicht alle möglichen Kombinationen aus Sprache und Region eindeutig identifizieren.
Hinweise für Aufrufer
.NET Framework 3.5 und frühere Versionen lösen ein ArgumentException , wenn culture es sich nicht um einen gültigen Kulturbezeichner handelt. Ab .NET Framework 4 löst diese Methode ein CultureNotFoundException. 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 eine .CultureNotFoundException
In .NET 6 und höheren Versionen wird ein CultureNotFoundException Fehler ausgelöst, wenn die App in einer Umgebung ausgeführt wird, in der der Globalisierungs-invariante 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)
- Quelle:
- CultureInfo.cs
- Quelle:
- CultureInfo.cs
- Quelle:
- CultureInfo.cs
- Quelle:
- CultureInfo.cs
- Quelle:
- CultureInfo.cs
Ruft eine zwischengespeicherte, 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.CultureInfoPublic Shared Function GetCultureInfo (name As String) As CultureInfoParameter
- name
- String
Der Name einer Kultur. bei name wird die Groß-/Kleinschreibung nicht beachtet.
Gibt zurück
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 Anrufern".
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 folgen dem 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 es sich um den Namen der aktuellen Kultur handelt, 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 die mehrere Kulturen effizient laden müssen.
Wenn name ja 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 3.5 und frühere Versionen lösen einen ArgumentException Ungültigen name Kulturnamen aus. Ab .NET Framework 4 löst diese Methode ein CultureNotFoundException. 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 es sich nicht um den Namen einer ergänzenden oder ersetzungskultur handelt, löst die Methode eine .CultureNotFoundException
In .NET 6 und höheren Versionen wird ein CultureNotFoundException Fehler ausgelöst, wenn die App in einer Umgebung ausgeführt wird, in der der Globalisierungs-invariante Modus aktiviert ist, z. B. einige Docker-Container und eine andere Kultur als die invariante Kultur angegeben wird.
