CultureInfo Konstruktoren

Quelle:

CultureInfo.cs

Quelle:

CultureInfo.cs

Quelle:

CultureInfo.cs

public:
 CultureInfo(int culture);

public CultureInfo (int culture);

new System.Globalization.CultureInfo : int -> System.Globalization.CultureInfo

Public Sub New (culture As Integer)

Parameter

Ausnahmen

Hinweise

Vordefinierte Kulturbezeichner für Kulturen, die im Windows-System verfügbar sind, werden in der Spalte Sprachtag in der Liste der von Windows unterstützten Sprach-/Regionsnamen aufgeführt. Kulturnamen befolgen den von BCP 47 definierten Standard.

In den meisten Fällen wird der culture Parameter dem entsprechenden NLS-Gebietsschemabezeichner (National Language Support) zugeordnet. Der Wert des culture Parameters wird zum Wert der LCID -Eigenschaft des neuen CultureInfo.

Es wird empfohlen, den Gebietsschemanamenkonstruktor CultureInfo.CultureInfoaufzurufen, da Gebietsschemanamen LCIDs vorzuziehen sind. Für benutzerdefinierte Gebietsschemas ist ein Gebietsschemaname erforderlich.

Der Benutzer kann einige der Werte, die der aktuellen Kultur von Windows zugeordnet sind, über den Bereich der Regions- und Sprachoptionen der Systemsteuerung außer Kraft setzen. Beispielsweise kann der Benutzer das Datum in einem anderen Format anzeigen oder eine andere Währung als die Standardwährung für die Kultur verwenden. Wenn der angegebene Kulturbezeichner mit dem Kulturbezeichner der aktuellen Windows-Kultur übereinstimmt, erstellt dieser Konstruktor eine CultureInfo , die diese Außerkraftsetzungen verwendet, einschließlich Benutzereinstellungen für die Eigenschaften der von der DateTimeFormatInfoDateTimeFormat -Eigenschaft zurückgegebenen Instanz und die Eigenschaften der von der NumberFormatInfoNumberFormat -Eigenschaft zurückgegebenen Instanz. Wenn die Benutzereinstellungen nicht mit der Kultur kompatibel sind, die CultureInfo dem zugeordnet ist (z. B. wenn der ausgewählte Kalender keiner der OptionalCalendarsist), sind die Ergebnisse der Methoden und die Werte der Eigenschaften nicht definiert.

Wenn der angegebene Kulturbezeichner nicht mit dem Bezeichner der aktuellen Windows-Kultur übereinstimmt, erstellt dieser Konstruktor eine CultureInfo , die die Standardwerte für die angegebene Kultur verwendet.

Die UseUserOverride -Eigenschaftensatz ist immer auf true.

Angenommen, Arabisch (Saudi-Arabien) ist die aktuelle Windows-Kultur und der Benutzer hat den Kalender von Hijri in Gregorianisch geändert.

• Mit CultureInfo("0x0401") (Kulturname ar-SA) Calendar ist auf GregorianCalendar (dies ist die Benutzereinstellung) und UseUserOverride auf truefestgelegt.

• Mit CultureInfo("0x041E") (Kulturname th-TH) Calendar ist auf ThaiBuddhistCalendar (der Standardkalender für th-TH) und UseUserOverride auf truefestgelegt.

Für Kulturen, die den Euro verwenden, legen .NET Framework und Windows XP die Standardwährung auf Euro fest. Ältere Versionen von Windows sind dies jedoch nicht. Wenn der Benutzer einer älteren Version von Windows die Währungseinstellung nicht über den Bereich der Regional- und Sprachoptionen der Systemsteuerung geändert hat, ist die Währung möglicherweise falsch. Um die .NET Framework-Standardeinstellung für die Währung zu verwenden, sollte die Anwendung eine CultureInfo Konstruktorüberladung verwenden, die einen useUserOverride Parameter akzeptiert und auf falsefestlegen.

Hinweise für Aufrufer

.NET Framework 3.5 und frühere Versionen lösen eine aus ArgumentException , wenn culture kein gültiger Kulturbezeichner ist. Ab .NET Framework 4 löst dieser Konstruktor einen aus 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 culture . Wenn das Betriebssystem diese Kultur nicht unterstützt, löst die Methode eine Ausnahme aus CultureNotFoundException .

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

• LCID
• UseUserOverride

Quelle:

CultureInfo.cs

Quelle:

CultureInfo.cs

Quelle:

CultureInfo.cs

public:
 CultureInfo(System::String ^ name);

public CultureInfo (string name);

new System.Globalization.CultureInfo : string -> System.Globalization.CultureInfo

Public Sub New (name As String)

Parameter

Ausnahmen

Beispiele

Im folgenden Beispiel wird die aktuelle Kultur abgerufen. Wenn es sich um etwas anderes als die französische Kultur (Frankreich) handelt, ruft er den CultureInfo(String) Konstruktor auf, um ein CultureInfo Objekt zu instanziieren, das die französische Kultur (Frankreich) darstellt und es zur aktuellen Kultur macht. Andernfalls instanziiert es ein CultureInfo Objekt, das die französische Kultur (Luxemburg) darstellt, und macht es zur aktuellen Kultur.

using System;
using System.Globalization;

public class ChangeEx1
{
    public static void Main()
    {
        CultureInfo current = CultureInfo.CurrentCulture;
        Console.WriteLine("The current culture is {0}", current.Name);
        CultureInfo newCulture;
        if (current.Name.Equals("fr-FR"))
            newCulture = new CultureInfo("fr-LU");
        else
            newCulture = new CultureInfo("fr-FR");

        CultureInfo.CurrentCulture = newCulture;
        Console.WriteLine("The current culture is now {0}",
                          CultureInfo.CurrentCulture.Name);
    }
}
// The example displays output like the following:
//     The current culture is en-US
//     The current culture is now fr-FR

Imports System.Globalization

Module Example
   Public Sub Main()
      Dim current As CultureInfo = CultureInfo.CurrentCulture
      Console.WriteLine("The current culture is {0}", current.Name)
      Dim newCulture As CultureInfo
      If current.Name.Equals("fr-FR") Then
         newCulture = New CultureInfo("fr-LU")
      Else
         newCulture = new CultureInfo("fr-FR")
      End If

      CultureInfo.CurrentCulture = newCulture
      Console.WriteLine("The current culture is now {0}",
                        CultureInfo.CurrentCulture.Name)
   End Sub
End Module
' The example displays output like the following:
'     The current culture is en-US
'     The current culture is now fr-FR

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.

Wenn name ist String.Empty, erstellt der Konstruktor eine Instanz der invarianten Kultur. Dies entspricht dem Abrufen des Werts der InvariantCulture Eigenschaft.

Der Benutzer kann einige der Werte, die der aktuellen Kultur von Windows zugeordnet sind, über den Bereich der Regions- und Sprachoptionen der Systemsteuerung außer Kraft setzen. Beispielsweise kann der Benutzer das Datum in einem anderen Format anzeigen oder eine andere Währung als die Standardwährung für die Kultur verwenden. Wenn der zugeordnete name Kulturbezeichner mit dem Kulturbezeichner der aktuellen Windows-Kultur übereinstimmt, erstellt dieser Konstruktor ein CultureInfo Objekt, das diese Außerkraftsetzungen verwendet, einschließlich Benutzereinstellungen für die Eigenschaften der Instanz, die DateTimeFormatInfo von der DateTimeFormat -Eigenschaft zurückgegeben werden, und die Eigenschaften der von der NumberFormatInfoNumberFormat -Eigenschaft zurückgegebenen Instanz. Wenn die Benutzereinstellungen mit der kultur nicht kompatibel sind, die CultureInfozugeordnet ist, z. B. wenn der ausgewählte Kalender keiner der OptionalCalendarsist, sind die Ergebnisse der Methoden und die Werte der Eigenschaften nicht definiert.

Wenn der zugeordnete name Kulturbezeichner nicht mit dem Kulturbezeichner der aktuellen Windows-Kultur übereinstimmt, erstellt dieser Konstruktor ein CultureInfo -Objekt, das die Standardwerte für die angegebene Kultur verwendet.

Die UseUserOverride -Eigenschaftensatz ist immer auf true.

Angenommen, Arabisch (Saudi-Arabien) ist die aktuelle Kultur von Windows, und der Benutzer hat den Kalender von Hijri in Gregorianisch geändert:

• Calendar Mit CultureInfo("ar-SA")wird auf GregorianCalendar festgelegt (dies ist die Benutzereinstellung) und UseUserOverride auf truefestgelegt.
• Calendar Mit CultureInfo("th-TH")ist auf ThaiBuddhistCalendar festgelegt (dies ist der Standardkalender für th-TH) und UseUserOverride auf truefestgelegt.

Die LCID -Eigenschaft der neuen CultureInfo wird auf den Kulturbezeichner festgelegt, der dem angegebenen Namen zugeordnet ist.

Hinweise für Aufrufer

.NET Framework 3.5 und frühere Versionen lösen einen aus ArgumentException , wenn name kein gültiger Kulturname ist. Ab .NET Framework 4 löst dieser Konstruktor einen aus 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 nicht der Name einer Ergänzenden oder Ersatzkultur ist, löst die Methode eine Ausnahme aus CultureNotFoundException .

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

• LCID
• UseUserOverride
• CreateSpecificCulture(String)

Quelle:

CultureInfo.cs

Quelle:

CultureInfo.cs

Quelle:

CultureInfo.cs

public:
 CultureInfo(int culture, bool useUserOverride);

public CultureInfo (int culture, bool useUserOverride);

new System.Globalization.CultureInfo : int * bool -> System.Globalization.CultureInfo

Public Sub New (culture As Integer, useUserOverride As Boolean)

Parameter

Ausnahmen

Hinweise

Vordefinierte Kulturbezeichner, die auf Windows-Systemen verfügbar sind, werden in der Spalte Sprachtag in der Liste der von Windows unterstützten Sprach-/Regionsnamen aufgeführt. Kulturnamen befolgen den von BCP 47 definierten Standard.

In den meisten Fällen wird der culture Parameter dem entsprechenden NLS-Gebietsschemabezeichner (National Language Support) zugeordnet. Der Wert des culture Parameters wird zum Wert der LCID -Eigenschaft des neuen CultureInfo.

Es wird empfohlen, den Gebietsschemanamenkonstruktor CultureInfo.CultureInfoaufzurufen, da Gebietsschemanamen LCIDs vorzuziehen sind. Für benutzerdefinierte Gebietsschemas ist ein Gebietsschemaname erforderlich.

Der Benutzer kann einige der Werte, die der aktuellen Kultur von Windows zugeordnet sind, über den Bereich der Regions- und Sprachoptionen der Systemsteuerung außer Kraft setzen. Beispielsweise kann der Benutzer das Datum in einem anderen Format anzeigen oder eine andere Währung als die Standardwährung für die Kultur verwenden.

Anwendungen sollten Benutzerüberschreibungen in der Regel nicht zulassen. Das Deaktivieren von Außerkraftsetzungen garantiert selbst keine Datenstabilität. Weitere Informationen finden Sie im Blogeintrag Kulturdaten sollten nicht als stabil angesehen werden (mit Ausnahme von Invariant).

Wenn die UseUserOverride -Eigenschaft auf true festgelegt ist und der angegebene Kulturbezeichner mit dem Bezeichner der aktuellen Windows-Kultur übereinstimmt, erstellt dieser Konstruktor eine CultureInfo , die diese Außerkraftsetzungen verwendet, einschließlich Benutzereinstellungen für die Eigenschaften der von der DateTimeFormatInfoDateTimeFormat -Eigenschaft zurückgegebenen Instanz und die Eigenschaften der von der NumberFormatInfoNumberFormat -Eigenschaft zurückgegebenen Instanz. Wenn die Benutzereinstellungen mit der kultur nicht kompatibel sind, die CultureInfozugeordnet ist, z. B. wenn der ausgewählte Kalender keiner der OptionalCalendarsist, sind die Ergebnisse der Methoden und die Werte der Eigenschaften nicht definiert.

Andernfalls erstellt dieser Konstruktor eine CultureInfo , die die Standardwerte für die angegebene Kultur verwendet.

Der Wert des useUserOverride Parameters wird zum Wert der UseUserOverride -Eigenschaft.

Angenommen, Arabisch (Saudi-Arabien) ist die aktuelle Kultur von Windows und der Benutzer hat den Kalender von Hijri in Gregorianisch geändert.

• Mit CultureInfo("0x0401", true) (Kulturname ar-SA) Calendar ist auf GregorianCalendar (dies ist die Benutzereinstellung) und UseUserOverride auf truefestgelegt.

• Mit CultureInfo("0x0401", false) (Kulturname ar-SA) Calendar ist auf HijriCalendar (der Standardkalender für ar-SA) und UseUserOverride auf falsefestgelegt.

• Mit CultureInfo("0x041E", true) (Kulturname th-TH) Calendar ist auf ThaiBuddhistCalendar (der Standardkalender für th-TH) und UseUserOverride auf truefestgelegt.

• Mit CultureInfo("0x041E", false) (Kulturname th-TH) Calendar ist auf ThaiBuddhistCalendar (der Standardkalender für th-TH) und UseUserOverride auf falsefestgelegt.

Für Kulturen, die den Euro verwenden, legen .NET Framework und Windows XP die Standardwährung auf Euro fest. Ältere Versionen von Windows tun dies jedoch nicht. Wenn der Benutzer einer älteren Version von Windows die Währungseinstellung nicht über den Bereich Regional- und Sprachoptionen der Systemsteuerung geändert hat, ist die Währung möglicherweise falsch. Um die .NET Framework-Standardeinstellung für die Währung zu verwenden, sollte die Anwendung den useUserOverride Parameter auf falsefestlegen.

Hinweise für Aufrufer

.NET Framework 3.5 und frühere Versionen lösen eine aus ArgumentException , wenn culture kein gültiger Kulturbezeichner ist. Ab .NET Framework 4 löst dieser Konstruktor einen aus 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 culture . Wenn das Betriebssystem diese Kultur nicht unterstützt, löst die Methode eine Ausnahme aus CultureNotFoundException .

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

• LCID
• UseUserOverride

Quelle:

CultureInfo.cs

Quelle:

CultureInfo.cs

Quelle:

CultureInfo.cs

public:
 CultureInfo(System::String ^ name, bool useUserOverride);

public CultureInfo (string name, bool useUserOverride);

new System.Globalization.CultureInfo : string * bool -> System.Globalization.CultureInfo

Public Sub New (name As String, useUserOverride As Boolean)

Parameter

Ausnahmen

Hinweise

Eine Liste der vordefinierten Kulturnamen finden Sie in der Spalte Language-Tag 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.

Wenn name ist String.Empty, erstellt der Konstruktor eine Instanz der invariante Kultur. Dies entspricht dem Abrufen des Werts der InvariantCulture -Eigenschaft.

Der Benutzer kann einige der Werte, die der aktuellen Windows-Kultur zugeordnet sind, über den Bereich Regional- und Sprachoptionen der Systemsteuerung außer Kraft setzen. Beispielsweise kann der Benutzer das Datum in einem anderen Format anzeigen oder eine andere Währung als die Standardwährung für die Kultur verwenden.

Anwendungen sollten Benutzerüberschreibungen in der Regel nicht zulassen. Das Deaktivieren von Außerkraftsetzungen garantiert selbst keine Datenstabilität. Weitere Informationen finden Sie im Blogeintrag Kulturdaten sollten nicht als stabil betrachtet werden (mit Ausnahme von Invariant).

Wenn die UseUserOverride -Eigenschaft auf true festgelegt ist und der dem angegebenen Kulturnamen zugeordnete Kulturbezeichner mit dem Kulturbezeichner der aktuellen Windows-Kultur übereinstimmt, erstellt dieser Konstruktor eine CultureInfo , die diese Außerkraftsetzungen verwendet, einschließlich Benutzereinstellungen für die Eigenschaften der von der DateTimeFormatInfoDateTimeFormat -Eigenschaft zurückgegebenen Instanz und die Eigenschaften der NumberFormatInfo von der NumberFormat -Eigenschaft zurückgegebenen Instanz. Wenn die Benutzereinstellungen mit der kultur nicht kompatibel sind, die CultureInfodem zugeordnet ist, z. B. wenn der ausgewählte Kalender nicht einer der OptionalCalendarsist, sind die Ergebnisse der Methoden und die Werte der Eigenschaften nicht definiert.

Andernfalls erstellt dieser Konstruktor einen CultureInfo , der die Standardwerte für die angegebene Kultur verwendet.

Der Wert des useUserOverride Parameters wird zum Wert der UseUserOverride -Eigenschaft.

Angenommen, Arabisch (Saudi-Arabien) ist die aktuelle Kultur von Windows und der Benutzer hat den Kalender von Hijri in Gregorianisch geändert.

• Mit CultureInfo("ar-SA", true)ist auf Calendar festgelegt GregorianCalendar (die Benutzereinstellung) und UseUserOverride auf truefestgelegt.

• Mit CultureInfo("ar-SA", false)wird auf HijriCalendar festgelegt (dies ist der Standardkalender für ar-SA) und UseUserOverride auf falsefestgelegt. Calendar

• Mit CultureInfo("th-TH", true)wird auf CalendarThaiBuddhistCalendar festgelegt (dies ist der Standardkalender für th-TH) und UseUserOverride auf truefestgelegt.

• Mit CultureInfo("th-TH", false)wird auf CalendarThaiBuddhistCalendar festgelegt (dies ist der Standardkalender für th-TH) und UseUserOverride auf falsefestgelegt.

Die LCID Eigenschaft des neuen CultureInfo wird auf den Kulturbezeichner festgelegt, der dem angegebenen Namen zugeordnet ist.

Für Kulturen, die den Euro verwenden, legen .NET Framework und Windows XP die Standardwährung auf Euro fest. Ältere Versionen von Windows tun dies jedoch nicht. Wenn der Benutzer einer älteren Version von Windows die Währungseinstellung nicht über den Bereich Regional- und Sprachoptionen der Systemsteuerung geändert hat, ist die Währung möglicherweise falsch. Um die .NET Framework-Standardeinstellung für die Währung zu verwenden, sollte die Anwendung den useUserOverride Parameter auf falsefestlegen.

Hinweise für Aufrufer

.NET Framework 3.5 und frühere Versionen lösen einen aus ArgumentException , wenn name kein gültiger Kulturname ist. Ab .NET Framework 4 löst dieser Konstruktor einen aus 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 aus dem Betriebssystem stammt name . Wenn das Betriebssystem diese Kultur nicht unterstützt, und wenn name es sich nicht um den Namen einer zusätzlichen Kultur oder einer Ersatzkultur handelt, löst die Methode eine Ausnahme aus CultureNotFoundException .

In .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

• LCID
• UseUserOverride
• CreateSpecificCulture(String)