CultureInfo Konstruktoren

Quelle:

CultureInfo.cs

Quelle:

CultureInfo.cs

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 unter Windows-System verfügbar sind, werden in der Liste der von Windows unterstützten Sprach-/Regionsnamen in der Spalte "Sprache" aufgeführt. Kulturnamen folgen dem von BCP 47 definierten Standard.

In den meisten Fällen wird der culture Parameter dem entsprechenden GEBIETSSCHEMA-Bezeichner (National Language Support, NLS) 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.

Die Benutzer*innen können über den Bereich für Regions- und Sprachoptionen der Systemsteuerung einige der Werte außer Kraft setzen, die der aktuellen Kultur von Windows zugeordnet sind. Beispielsweise können Benutzer*innen 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 dem Kulturbezeichner der aktuellen Windows-Kultur entspricht, erstellt dieser Konstruktor eine CultureInfo , die diese Außerkraftsetzungen verwendet, einschließlich der Benutzereinstellungen für die Eigenschaften der DateTimeFormatInfo instanz, die von der DateTimeFormat Eigenschaft zurückgegeben wird, und die Eigenschaften der NumberFormatInfo von der NumberFormat Eigenschaft zurückgegebenen Instanz. Wenn die Benutzereinstellungen nicht mit der Kultur kompatibel sind, die mit dem CultureInfo (z. B. nicht dem ausgewählten Kalender) verknüpft ist OptionalCalendars, 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 Eigenschaft ist immer auf true.

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

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

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

Für Kulturen, die den Euro verwenden, legen .NET Framework und Windows XP die Standardwährung als Euro fest. Ältere Versionen von Windows sind jedoch nicht. Wenn der Benutzer einer älteren Windows-Version die Währungseinstellung über den Bereich "Regions- und Sprachoptionen" der Systemsteuerung nicht 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 .false

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 dieser Konstruktor einen 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 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

• LCID
• UseUserOverride

Quelle:

CultureInfo.cs

Quelle:

CultureInfo.cs

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 nicht um die französische Kultur (Frankreich) handelt, ruft er den CultureInfo(String) Konstruktor auf, 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 es zur aktuellen Kultur macht.

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 folgen dem von BCP 47 definierten Standard. Darüber hinaus kann ab Windows 10 name ein beliebiges gültiges BCP-47-Sprachtag sein.

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

Die Benutzer*innen können über den Bereich für Regions- und Sprachoptionen der Systemsteuerung einige der Werte außer Kraft setzen, die der aktuellen Kultur von Windows zugeordnet sind. Beispielsweise können Benutzer*innen das Datum in einem anderen Format anzeigen oder eine andere Währung als die Standardwährung für die Kultur verwenden. Wenn der kulturbezeichner, name der dem Kulturbezeichner der aktuellen Windows-Kultur zugeordnet ist, erstellt dieser Konstruktor ein CultureInfo Objekt, das diese Außerkraftsetzungen verwendet, einschließlich der Benutzereinstellungen für die Eigenschaften der DateTimeFormatInfo Instanz, die von der DateTimeFormat Eigenschaft zurückgegeben wird, und die Eigenschaften der NumberFormatInfo von der NumberFormat Eigenschaft zurückgegebenen Instanz. Wenn die Benutzereinstellungen nicht mit der Kultur kompatibel sind, die CultureInfo zugeordnet ist (z. B. wenn der ausgewählte Kalender nicht einer der OptionalCalendars ist), werden die Ergebnisse der Methoden und die Werte der Eigenschaften nicht definiert.

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

Die UseUserOverride Eigenschaft ist immer auf true.

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

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

Die LCID Eigenschaft des 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 ArgumentException Ungültigen name Kulturnamen aus. Ab .NET Framework 4 löst dieser Konstruktor einen 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

• LCID
• UseUserOverride
• CreateSpecificCulture(String)

Quelle:

CultureInfo.cs

Quelle:

CultureInfo.cs

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 Liste der von Windows unterstützten Sprach-/Regionsnamen in der Spalte "Sprachtag" aufgeführt. Kulturnamen folgen dem von BCP 47 definierten Standard.

In den meisten Fällen wird der culture Parameter dem entsprechenden GEBIETSSCHEMA-Bezeichner (National Language Support, NLS) 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.

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

Anwendungen sollten in der Regel keine Außerkraftsetzungen des Benutzers zulassen. Das Disalloieren von Außerkraftsetzungen garantiert nicht selbst die Datenstabilität. Weitere Informationen finden Sie im Blogeintrag Culture data shouldn't be considered stable (except for Invariant).

Wenn die UseUserOverride Eigenschaft auf true und der angegebene Kulturbezeichner mit dem Bezeichner der aktuellen Windows-Kultur übereinstimmt, erstellt dieser Konstruktor eine CultureInfo , die diese Außerkraftsetzungen verwendet, einschließlich der Benutzereinstellungen für die Eigenschaften der DateTimeFormatInfo Instanz, die von der DateTimeFormat Eigenschaft zurückgegeben wird, und die Eigenschaften der NumberFormatInfo von der NumberFormat Eigenschaft zurückgegebenen Instanz. Wenn die Benutzereinstellungen nicht mit der Kultur kompatibel sind, die CultureInfo zugeordnet ist (z. B. wenn der ausgewählte Kalender nicht einer der OptionalCalendars ist), werden 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 Windows-Kultur, und der Benutzer hat den Kalender von Hijri in Gregorian geändert.

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

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

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

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

Für Kulturen, die den Euro verwenden, legen .NET Framework und Windows XP die Standardwährung als Euro fest. Ältere Versionen von Windows sind jedoch nicht. Wenn der Benutzer einer älteren Windows-Version die Währungseinstellung über den Bereich "Regions- und Sprachoptionen" der Systemsteuerung nicht 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 false.

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 dieser Konstruktor einen 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 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

• LCID
• UseUserOverride

Quelle:

CultureInfo.cs

Quelle:

CultureInfo.cs

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 vordefinierter Kulturnamen 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.

Wenn name dies der Fall 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 außer Kraft setzen, die der aktuellen Windows-Kultur zugeordnet sind, über den Bereich "Regions- und Sprachoptionen" der Systemsteuerung. Beispielsweise können Benutzer*innen das Datum in einem anderen Format anzeigen oder eine andere Währung als die Standardwährung für die Kultur verwenden.

Anwendungen sollten in der Regel keine Außerkraftsetzungen des Benutzers zulassen. Das Disalloieren von Außerkraftsetzungen garantiert nicht selbst die Datenstabilität. Weitere Informationen finden Sie im Blogeintrag Culture data shouldn't be considered stable (except for Invariant).

Wenn die UseUserOverride Eigenschaft auf true und der Kulturbezeichner, der dem angegebenen Kulturnamen zugeordnet ist, mit dem Kulturbezeichner der aktuellen Windows-Kultur übereinstimmt, erstellt dieser Konstruktor eine CultureInfo Solche, die diese Außerkraftsetzungen verwendet, einschließlich Der Benutzereinstellungen für die Eigenschaften der DateTimeFormatInfo Instanz, die von der DateTimeFormat Eigenschaft zurückgegeben wird, und die Eigenschaften der NumberFormatInfo instanz, die von der NumberFormat Eigenschaft zurückgegeben wird. Wenn die Benutzereinstellungen nicht mit der Kultur kompatibel sind, die CultureInfo zugeordnet ist (z. B. wenn der ausgewählte Kalender nicht einer der OptionalCalendars ist), werden 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 Windows-Kultur und der Benutzer hat den Kalender von Hijri in Gregorian geändert.

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

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

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

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

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 als Euro fest. Ältere Versionen von Windows tun dies jedoch nicht. Wenn der Benutzer einer älteren Windows-Version die Währungseinstellung über den Bereich "Regions- und Sprachoptionen" der Systemsteuerung nicht 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 false.

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 dieser Konstruktor einen 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

• LCID
• UseUserOverride
• CreateSpecificCulture(String)