CultureInfo-Konstruktor (String, Boolean)

Initialisiert eine neue Instanz der CultureInfo-Klasse auf der Grundlage der durch den Namen 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 ( _
    name As String, _
    useUserOverride As Boolean _
)
'Usage
Dim name As String
Dim useUserOverride As Boolean

Dim instance As New CultureInfo(name, useUserOverride)

public CultureInfo (
    string name,
    bool useUserOverride
)

public:
CultureInfo (
    String^ name, 
    bool useUserOverride
)

public CultureInfo (
    String name, 
    boolean useUserOverride
)

public function CultureInfo (
    name : String, 
    useUserOverride : boolean
)

Parameter

• name
  Ein vordefinierter CultureInfo-Name, eine Name-Eigenschaft einer vorhandenen CultureInfo-Klasse oder ein Nur-Windows-Kulturname.

• 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

Hinweise

Die CultureInfo-Namen folgen dem Standard RFC 1766 und haben das Format "<Sprachcode2>-<Landes-/Regionscode2>". Dabei ist <Sprachcode2> ein aus ISO 639-1 abgeleiteter Code aus zwei Kleinbuchstaben, und <Landes-/Regionscode2> ist ein Code aus zwei Großbuchstaben nach ISO 3166. Beispielsweise wird für Englisch (USA) "en-US" verwendet. In Fällen, in denen ein Sprachcode aus zwei Buchstaben nicht zur Verfügung steht, wird der aus ISO 639-2 abgeleitete Code aus drei Buchstaben verwendet. Der aus drei Buchstaben bestehende Code "div" wird beispielsweise für Kulturen verwendet, die die Sprache Dhivehi verwenden. Die vordefinierten CultureInfo-Namen sind unter dem Thema CultureInfo-Klasse aufgelistet.

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

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("ar-SA", true) (Kulturbezeichner "0x0401") wird Calendar auf GregorianCalendar (die Benutzereinstellung) und UseUserOverride auf true festgelegt.

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

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

• Mit CultureInfo("th-TH", false) (Kulturbezeichner "0x041E") 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
CreateSpecificCulture