CultureInfo-Konstruktor (String)
Initialisiert eine neue Instanz der CultureInfo-Klasse auf der Grundlage der durch den Namen angegebenen Kultur.
Namespace: System.Globalization
Assembly: mscorlib (in mscorlib.dll)
Syntax
'Declaration
Public Sub New ( _
name As String _
)
'Usage
Dim name As String
Dim instance As New CultureInfo(name)
public CultureInfo (
string name
)
public:
CultureInfo (
String^ name
)
public CultureInfo (
String name
)
public function CultureInfo (
name : String
)
Parameter
- name
Ein vordefinierter CultureInfo-Name, eine Name-Eigenschaft einer vorhandenen CultureInfo-Klasse oder ein Nur-Windows-Kulturname.
Ausnahmen
| Ausnahmetyp | Bedingung |
|---|---|
name ist NULL (Nothing in Visual Basic). |
|
name ist kein gültiger Kulturname. – oder – In .NET Compact Framework-Anwendungen wird culture vom Betriebssystem des Geräts nicht unterstützt. |
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 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 mit dem angegebenen Kulturnamen verbundene 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("ar-SA")(Kulturbezeichner "0x0401") wird Calendar auf GregorianCalendar (die Benutzereinstellung) und UseUserOverride auf true festgelegt.Mit
CultureInfo("th-TH")(Kulturbezeichner "0x041E") 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
CreateSpecificCulture