Freigeben über


CultureInfo-Konstruktor (Int32)

Initialisiert eine neue Instanz der CultureInfo-Klasse auf der Grundlage der durch den Kulturbezeichner angegebenen Kultur.

Namespace: System.Globalization
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Sub New ( _
    culture As Integer _
)
'Usage
Dim culture As Integer

Dim instance As New CultureInfo(culture)
public CultureInfo (
    int culture
)
public:
CultureInfo (
    int culture
)
public CultureInfo (
    int culture
)
public function CultureInfo (
    culture : int
)

Parameter

  • culture
    Ein vordefinierter CultureInfo-Bezeichner, die LCID-Eigenschaft eines vorhandenen CultureInfo-Objekts oder ein Nur-Windows-Kulturbezeichner.

Ausnahmen

Ausnahmetyp Bedingung

ArgumentOutOfRangeException

culture ist kleiner als 0 (null).

ArgumentException

culture ist kein gültiger Kulturbezeichner.

– oder –

In .NET Compact Framework-Anwendungen wird culture vom Betriebssystem des Geräts nicht unterstützt.

Hinweise

Die vordefinierten Kulturbezeichner sind unter dem Thema CultureInfo-Klasse aufgelistet.

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

In der Systemsteuerung können über Regions- und Sprachoptionen (bzw. über Ländereinstellungen oder Gebietsschema) einige Werte überschrieben werden, die der aktuellen Kultur von Windows zugeordnet sind. Beispielsweise können Benutzer das Datum in einem anderen Format anzeigen oder eine andere Währung als die Standardwährung der Kultur verwenden.

Wenn der angegebene Kulturbezeichner mit dem Kulturbezeichner der aktuellen Windows-Kultur übereinstimmt, erstellt dieser Konstruktor eine CultureInfo, die diese Überschreibungen verwendet, einschließlich der Benutzereinstellungen für die Eigenschaften der von der DateTimeFormat-Eigenschaft zurückgegebenen DateTimeFormatInfo-Instanz und für die Eigenschaften der von der NumberFormat-Eigenschaft zurückgegebenen NumberFormatInfo-Instanz. Wenn die Benutzereinstellungen nicht mit der Kultur kompatibel sind, die der CultureInfo zugeordnet ist, weil z. B. der ausgewählte Kalender keiner der OptionalCalendars ist, sind die Methodenergebnisse und Eigenschaftenwerte undefiniert.

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

Die UseUserOverride-Eigenschaft wird immer auf true festgelegt.

Angenommen, "Arabisch – Saudi-Arabien" (Kulturname "ar-SA", Kulturbezeichner "0x0401") ist die aktuelle Windows-Kultur, und der Benutzer hat den verwendeten Hidschra-Kalender in den gregorianischen Kalender geändert.

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

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

Für Kulturen, in denen der Euro verwendet wird, legen .NET Framework und Windows XP die Standardwährung auf Euro fest. Bei älteren Versionen von Windows ist dies nicht der Fall. Wenn Benutzer einer älteren Version von Windows die Währungseinstellung nicht in der Systemsteuerung in den Ländereinstellungen geändert haben, ist die Währungsangabe deshalb möglicherweise nicht korrekt. Wenn für die Währung die Standardeinstellung von .NET Framework verwendet werden soll, verwenden Sie eine Überladung des CultureInfo-Konstruktors, die einen useUserOverride-Parameter akzeptiert, und legen Sie diesen auf false fest.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

CultureInfo-Klasse
CultureInfo-Member
System.Globalization-Namespace
LCID
UseUserOverride