CultureInfo-Konstruktor (Int32, Boolean)

Artikel
08/20/2007

Initialisiert eine neue Instanz der CultureInfo-Klasse auf der Grundlage der durch den Kulturbezeichner angegebenen Kultur und auf der Grundlage des booleschen Werts, der angibt, ob die vom Benutzer ausgewählten Kultureinstellungen des Systems verwendet werden sollen.

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

Syntax

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

Dim instance As New CultureInfo(culture, useUserOverride)

public CultureInfo (
    int culture,
    bool useUserOverride
)

public:
CultureInfo (
    int culture, 
    bool useUserOverride
)

public CultureInfo (
    int culture, 
    boolean useUserOverride
)

public function CultureInfo (
    culture : int, 
    useUserOverride : boolean
)

Parameter

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

useUserOverride
Ein boolescher Wert, der angibt, ob die vom Benutzer ausgewählten Kultureinstellungen verwendet werden sollen (true) oder ob die Standardkultureinstellungen verwendet werden (false).

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.

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 die UseUserOverride-Eigenschaft auf true festgelegt ist und 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.

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

Der Wert des useUserOverride-Parameters nimmt den Wert der UseUserOverride-Eigenschaft an.

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", true) (Kulturname "ar-SA") wird Calendar auf GregorianCalendar (die Benutzereinstellung) und UseUserOverride auf true festgelegt.
Mit CultureInfo("0x0401", false) (Kulturname "ar-SA") wird Calendar auf HijriCalendar (den Standardkalender für "ar-SA") und UseUserOverride auf false festgelegt.
Mit CultureInfo("0x041E", true) (Kulturname "th-TH") wird Calendar auf ThaiBuddhistCalendar (den Standardkalender für "th-TH") und UseUserOverride auf true festgelegt.
Mit CultureInfo("0x041E", false) (Kulturname "th-TH") wird Calendar auf ThaiBuddhistCalendar (den Standardkalender für "th-TH") und UseUserOverride auf false 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. Um die Standardeinstellungen von .NET Framework für die Währung zu verwenden, legen Sie den useUserOverride-Parameter 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

Freigeben über