CultureInfo CultureInfo CultureInfo CultureInfo Constructors

Definition

Überlädt

CultureInfo(Int32) CultureInfo(Int32) CultureInfo(Int32) CultureInfo(Int32)

Initialisiert eine neue Instanz der CultureInfo-Klasse auf der Grundlage der durch den Kulturbezeichner angegebenen Kultur.Initializes a new instance of the CultureInfo class based on the culture specified by the culture identifier.

CultureInfo(String) CultureInfo(String) CultureInfo(String) CultureInfo(String)

Initialisiert eine neue Instanz der CultureInfo-Klasse auf der Grundlage der durch den Namen angegebenen Kultur.Initializes a new instance of the CultureInfo class based on the culture specified by name.

CultureInfo(Int32, Boolean) CultureInfo(Int32, Boolean) CultureInfo(Int32, Boolean) CultureInfo(Int32, Boolean)

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.Initializes a new instance of the CultureInfo class based on the culture specified by the culture identifier and on the Boolean that specifies whether to use the user-selected culture settings from the system.

CultureInfo(String, Boolean) CultureInfo(String, Boolean) CultureInfo(String, Boolean) CultureInfo(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.Initializes a new instance of the CultureInfo class based on the culture specified by name and on the Boolean that specifies whether to use the user-selected culture settings from the system.

CultureInfo(Int32) CultureInfo(Int32) CultureInfo(Int32) CultureInfo(Int32)

Initialisiert eine neue Instanz der CultureInfo-Klasse auf der Grundlage der durch den Kulturbezeichner angegebenen Kultur.Initializes a new instance of the CultureInfo class based on the culture specified by the culture identifier.

public:
 CultureInfo(int culture);
public CultureInfo (int culture);
new System.Globalization.CultureInfo : int -> System.Globalization.CultureInfo
Public Sub New (culture As Integer)

Parameter

culture
Int32 Int32 Int32 Int32

Ein vordefinierter CultureInfo-Bezeichner, die LCID-Eigenschaft eines vorhandenen CultureInfo-Objekts oder ein Nur-Windows-Kulturbezeichner.A predefined CultureInfo identifier, LCID property of an existing CultureInfo object, or Windows-only culture identifier.

Ausnahmen

culture ist kein gültiger Kulturbezeichner.culture is not a valid culture identifier. Weitere Informationen finden Sie im Abschnitt „Hinweise zu Aufrufern“.See the Notes to Callers section for more information.

Hinweise

Vordefinierte Kulturbezeichner finden Sie in der National Language Support (NLS) API-Referenz am Go Global Developer Center.Predefined culture identifiers are listed in the National Language Support (NLS) API Reference at the Go Global Developer Center.

In den meisten Fällen die culture Parameter dem entsprechenden National Language Support (NLS) Gebietsschemabezeichner zugeordnet ist.In most cases, the culture parameter is mapped to the corresponding National Language Support (NLS) locale identifier. Der Wert des der culture Parameter wird der Wert des der LCID -Eigenschaft des neuen CultureInfo.The value of the culture parameter becomes the value of the LCID property of the new CultureInfo.

Es wird empfohlen, dass Sie die Gebietsschema-Namen-Konstruktor aufrufen CultureInfo.CultureInfo, da Gebietsschemanamen LCIDs vorzuziehen sind.We recommend that you call the locale name constructor CultureInfo.CultureInfo, because locale names are preferable to LCIDs. Bei benutzerdefinierten Gebietsschemas ist der Name eines Gebietsschemas erforderlich.For custom locales, a locale name is required.

Der Benutzer möglicherweise zum Überschreiben einiger der aktuellen Kultur von Windows über die Regions- und spracheinstellungen des Teils der Optionen der Systemsteuerung zugeordneten Werte auswählen.The user might choose to override some of the values associated with the current culture of Windows through the regional and language options portion of Control Panel. Der Benutzer könnte z. B. zum Anzeigen des Datums in einem anderen Format oder keine andere als die Standardeinstellung für die Kultur zu verwenden.For example, the user might choose to display the date in a different format or to use a currency other than the default for the culture. Wenn der angegebenen Kulturbezeichner den Kulturbezeichner für die aktuelle Windows-Kultur entspricht, wird dieser Konstruktor erstellt ein CultureInfo , verwendet diese Außerkraftsetzungen, einschließlich der Einstellungen für die Eigenschaften des Benutzers die DateTimeFormatInfo vom zurückgegebene Instanz der DateTimeFormat -Eigenschaft, und die Eigenschaften der NumberFormatInfo vom zurückgegebene Instanz der NumberFormat Eigenschaft.If the specified culture identifier matches the culture identifier of the current Windows culture, this constructor creates a CultureInfo that uses those overrides, including user settings for the properties of the DateTimeFormatInfo instance returned by the DateTimeFormat property, and the properties of the NumberFormatInfo instance returned by the NumberFormat property. Wenn die benutzereinstellungen nicht kompatibel mit der Kultur zugeordnet sind die CultureInfo (z. B., wenn eine der nicht der ausgewählte Kalender ist die OptionalCalendars) die Ergebnisse der Methoden und die Werte der Eigenschaften sind nicht definiert.If the user settings are incompatible with the culture associated with the CultureInfo (for example, if the selected calendar is not one of the OptionalCalendars) the results of the methods and the values of the properties are undefined.

Wenn der angegebenen Kulturbezeichner den Bezeichner für die aktuelle Windows-Kultur nicht übereinstimmt, wird dieser Konstruktor erstellt ein CultureInfo , die die Standardwerte für die angegebene Kultur verwendet.If the specified culture identifier does not match the identifier of the current Windows culture, this constructor creates a CultureInfo that uses the default values for the specified culture.

Die UseUserOverride -Eigenschaftensatz ist immer auf true.The UseUserOverride property is always set to true.

Nehmen wir beispielsweise an, dass Arabisch (Saudi-Arabien) die aktuelle Windows-Kultur ist und der Benutzer hat den Kalender von Hijri gregorianische geändert.For example, suppose that Arabic (Saudi Arabia) is the current Windows culture and the user has changed the calendar from Hijri to Gregorian.

Für die Kulturen, die mit den Euro, wird .NET Framework und Windows XP standardmäßig Währung als Euro festlegen.For cultures that use the euro, the .NET Framework and Windows XP set the default currency as euro. Werden jedoch in ältere Versionen von Windows nicht.However, older versions of Windows do not. Wenn der Benutzer eine ältere Version von Windows nicht die Einstellung "Währung" über die Regions- und spracheinstellungen des Teils der Optionen der Systemsteuerung geändert hat, kann die Währung aus diesem Grund falsch sein.Therefore, if the user of an older version of Windows has not changed the currency setting through the regional and language options portion of Control Panel, the currency might be incorrect. Um die .NET Framework-Standardeinstellung für die Währung zu verwenden, sollte die Anwendung verwenden eine CultureInfo Konstruktorüberladung, die akzeptiert eine useUserOverride Parameter und setzen es auf false.To use the .NET Framework default setting for the currency, the application should use a CultureInfo constructor overload that accepts a useUserOverride parameter and set it to false.

Hinweis

Für Abwärtskompatibilität einer Kultur mithilfe einer culture Parameter 0 x 0004 oder 0x7c04 besitzen, wird eine Name Eigenschaft Zh-CHS oder Zh-CHT bzw.For backwards compatibility, a culture constructed using a culture parameter of 0x0004 or 0x7c04 will have a Name property of zh-CHS or zh-CHT, respectively. Sie sollten stattdessen lieber die Kultur, die über die aktuellen Namen der Standardkultur des Zh-Hans oder Zh-Hant, erstellen, wenn Sie einen Grund für die Verwendung der älteren Namen haben.You should instead prefer to construct the culture using the current standard culture names of zh-Hans or zh-Hant, unless you have a reason for using the older names.

Hinweise für Aufrufer

Die .NET Framework 3,5.NET Framework 3.5 und frühere Versionen lösen eine ArgumentException Wenn culture ist kein gültiger Kulturbezeichner.The .NET Framework 3,5.NET Framework 3.5 and earlier versions throw an ArgumentException if culture is not a valid culture identifier. Beginnend mit der .NET Framework 4.NET Framework 4, löst der Konstruktor eine CultureNotFoundException.Starting with the .NET Framework 4.NET Framework 4, this constructor throws a CultureNotFoundException. Beginnend mit apps, die unter ausgeführt der .NET Framework 4.NET Framework 4 oder höher unter Windows 7 oder höher, die Methode versucht, zum Abrufen einer CultureInfo Objekt, dessen Bezeichner culture vom Betriebssystem; Wenn das Betriebssystem, Kultur, nicht unterstützt die -Methode löst eine CultureNotFoundException Ausnahme.Starting with apps that run under the .NET Framework 4.NET Framework 4 or later on Windows 7 or later, the method attempts to retrieve a CultureInfo object whose identifier is culture from the operating system; if the operating system does not support that culture, the method throws a CultureNotFoundException exception.

Siehe auch

CultureInfo(String) CultureInfo(String) CultureInfo(String) CultureInfo(String)

Initialisiert eine neue Instanz der CultureInfo-Klasse auf der Grundlage der durch den Namen angegebenen Kultur.Initializes a new instance of the CultureInfo class based on the culture specified by name.

public:
 CultureInfo(System::String ^ name);
public CultureInfo (string name);
new System.Globalization.CultureInfo : string -> System.Globalization.CultureInfo
Public Sub New (name As String)

Parameter

name
String String String String

Ein vordefinierter CultureInfo-Name, eine Name-Eigenschaft einer vorhandenen CultureInfo-Klasse oder ein nur für Windows definierter Kulturname.A predefined CultureInfo name, Name of an existing CultureInfo, or Windows-only culture name. Bei name wird nicht zwischen Groß- und Kleinschreibung unterschieden.name is not case-sensitive.

Ausnahmen

name ist kein gültiger Kulturname.name is not a valid culture name. Weitere Informationen finden Sie im Abschnitt "Hinweise zu Aufrufern".For more information, see the Notes to Callers section.

Beispiele

Im folgende Beispiel ruft die aktuelle Kultur ab.The following example retrieves the current culture. Wenn es etwas anderes als die Kultur Französisch (Frankreich) ist, ruft sie die CultureInfo(String) Konstruktor zum Instanziieren einer CultureInfo -Objekt, das die Kultur Französisch (Frankreich) darstellt und die aktuelle Threadkultur erleichtert.If it is anything other than the French (France) culture, it calls the CultureInfo(String) constructor to instantiate a CultureInfo object that represents the French (France) culture and makes it the current thread culture. Andernfalls es instanziiert einen CultureInfo Objekt, das von der Kultur Französisch (Luxemburg), und erleichtert die aktuelle Kultur.Otherwise, it instantiates a CultureInfo object that represents the French (Luxembourg) culture and makes it the current culture.

using System;
using System.Globalization;

public class Example
{
   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 von vordefinierten Kulturnamen finden Sie in der National Language Support (NLS) API-Referenz am Go Global Developer Center.For a list of predefined culture names, see the National Language Support (NLS) API Reference at the Go Global Developer Center. Darüber hinaus beginnend mit Windows 10, name möglich, dass alle gültigen BCP-47-Sprachtag.In addition, starting with Windows 10, name can be any valid BCP-47 language tag.

Wenn name ist String.Empty, der Konstruktor erstellt eine Instanz der invarianten Kultur; Dies entspricht dem Abrufen des Werts der InvariantCulture Eigenschaft.If name is String.Empty, the constructor creates an instance of the invariant culture; this is equivalent to retrieving the value of the InvariantCulture property.

Der Benutzer möglicherweise zum Überschreiben einiger der aktuellen Kultur von Windows über die Regions- und spracheinstellungen des Teils der Optionen der Systemsteuerung zugeordneten Werte auswählen.The user might choose to override some of the values associated with the current culture of Windows through the regional and language options portion of Control Panel. Der Benutzer könnte z. B. zum Anzeigen des Datums in einem anderen Format oder keine andere als die Standardeinstellung für die Kultur zu verwenden.For example, the user might choose to display the date in a different format or to use a currency other than the default for the culture. Wenn der Kulturbezeichner zugeordnet name Übereinstimmungen, die der Kulturbezeichner für die aktuelle Windows-Kultur, dieser Konstruktor erstellt ein CultureInfo Objekt, das die Außerkraftsetzungen, einschließlich der benutzereinstellungen für für die Eigenschaften der verwendetDateTimeFormatInfovom zurückgegebene Instanz der DateTimeFormat -Eigenschaft, und die Eigenschaften der NumberFormatInfo vom zurückgegebene Instanz der NumberFormat Eigenschaft.If the culture identifier associated with name matches the culture identifier of the current Windows culture, this constructor creates a CultureInfo object that uses those overrides, including user settings for the properties of the DateTimeFormatInfo instance returned by the DateTimeFormat property, and the properties of the NumberFormatInfo instance returned by the NumberFormat property. Wenn die benutzereinstellungen nicht kompatibel mit der Kultur zugeordnet sind die CultureInfo, z. B. wenn einer der nicht der ausgewählte Kalender ist der OptionalCalendars, die Ergebnisse der Methoden und die Werte der Eigenschaften sind nicht definiert.If the user settings are incompatible with the culture associated with the CultureInfo, for example, if the selected calendar is not one of the OptionalCalendars, the results of the methods and the values of the properties are undefined.

Wenn der Kulturbezeichner zugeordnet name entspricht nicht der Kulturbezeichner für die aktuelle Windows-Kultur, dieser Konstruktor erstellt ein CultureInfo Objekt, das die Standardwerte für die angegebene Kultur verwendet.If the culture identifier associated with name does not match the culture identifier of the current Windows culture, this constructor creates a CultureInfo object that uses the default values for the specified culture.

Die UseUserOverride -Eigenschaftensatz ist immer auf true.The UseUserOverride property is always set to true.

Nehmen wir beispielsweise an, dass Arabisch (Saudi-Arabien) die aktuelle Kultur von Windows ist und der Benutzer in den gregorianischen Kalender von Hijri geändert.For example, suppose that Arabic (Saudi Arabia) is the current culture of Windows and the user changed the calendar from Hijri to Gregorian.

Die LCID -Eigenschaft des neuen CultureInfo festgelegt ist, auf die Kultur-ID, die dem angegebenen Namen zugeordnet.The LCID property of the new CultureInfo is set to the culture identifier associated with the specified name.

Für die Kulturen, die mit den Euro, wird .NET Framework und Windows XP standardmäßig Währung als Euro festlegen.For cultures that use the euro, the .NET Framework and Windows XP set the default currency as euro. Jedoch tun ältere Versionen von Windows nicht dies.However, older versions of Windows do not do this. Wenn der Benutzer eine ältere Version von Windows nicht die Einstellung "Währung" über die Regions- und spracheinstellungen des Teils der Optionen der Systemsteuerung geändert hat, kann die Währung aus diesem Grund falsch sein.Therefore, if the user of an older version of Windows has not changed the currency setting through the regional and language options portion of Control Panel, the currency might be incorrect. Um die .NET Framework-Standardeinstellung für die Währung zu verwenden, sollte die Anwendung verwenden eine CultureInfo Konstruktorüberladung, die akzeptiert eine useUserOverride Parameter und setzen es auf false.To use the .NET Framework default setting for the currency, the application should use a CultureInfo constructor overload that accepts a useUserOverride parameter and set it to false.

Hinweise für Aufrufer

Die .NET Framework 3,5.NET Framework 3.5 und frühere Versionen lösen eine ArgumentException Wenn name ist kein gültiger Kulturname.The .NET Framework 3,5.NET Framework 3.5 and earlier versions throw an ArgumentException if name is not a valid culture name. Beginnend mit der .NET Framework 4.NET Framework 4, löst der Konstruktor eine CultureNotFoundException.Starting with the .NET Framework 4.NET Framework 4, this constructor throws a CultureNotFoundException. Beginnend mit apps, die unter ausgeführt der .NET Framework 4.NET Framework 4 oder höher unter Windows 7 oder höher, die Methode versucht, Abrufen einer CultureInfo Objekt, dessen Bezeichner name vom Betriebssystem; Wenn das Betriebssystem diese Kultur nicht unterstützt und name ist nicht der Name einer Kultur zusätzliche oder ersetzt die löst die Methode eine CultureNotFoundException Ausnahme.Starting with apps that run under the .NET Framework 4.NET Framework 4 or later on Windows 7 or later, the method attempts to retrieve a CultureInfo object whose identifier is name from the operating system; if the operating system does not support that culture, and if name is not the name of a supplementary or replacement culture, the method throws a CultureNotFoundException exception.

Siehe auch

CultureInfo(Int32, Boolean) CultureInfo(Int32, Boolean) CultureInfo(Int32, Boolean) CultureInfo(Int32, Boolean)

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.Initializes a new instance of the CultureInfo class based on the culture specified by the culture identifier and on the Boolean that specifies whether to use the user-selected culture settings from the system.

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

culture
Int32 Int32 Int32 Int32

Ein vordefinierter CultureInfo-Bezeichner, die LCID-Eigenschaft eines vorhandenen CultureInfo-Objekts oder ein Nur-Windows-Kulturbezeichner.A predefined CultureInfo identifier, LCID property of an existing CultureInfo object, or Windows-only culture identifier.

useUserOverride
Boolean Boolean Boolean Boolean

Ein boolescher Wert, der angibt, ob die vom Benutzer ausgewählten Kultureinstellungen verwendet werden sollen (true) oder ob die Standardkultureinstellungen verwendet werden (false).A Boolean that denotes whether to use the user-selected culture settings (true) or the default culture settings (false).

Ausnahmen

culture ist kein gültiger Kulturbezeichner.culture is not a valid culture identifier. Weitere Informationen finden Sie im Abschnitt „Hinweise zu Aufrufern“.See the Notes to Callers section for more information.

Hinweise

Vordefinierte Kulturbezeichner finden Sie in der National Language Support (NLS) API-Referenz am Go Global Developer Center.Predefined culture identifiers are listed in the National Language Support (NLS) API Reference at the Go Global Developer Center.

In den meisten Fällen die culture Parameter dem entsprechenden National Language Support (NLS) Gebietsschemabezeichner zugeordnet ist.In most cases, the culture parameter is mapped to the corresponding National Language Support (NLS) locale identifier. Der Wert des der culture Parameter wird der Wert des der LCID -Eigenschaft des neuen CultureInfo.The value of the culture parameter becomes the value of the LCID property of the new CultureInfo.

Es wird empfohlen, dass Sie die Gebietsschema-Namen-Konstruktor aufrufen CultureInfo.CultureInfo, da Gebietsschemanamen LCIDs vorzuziehen sind.We recommend that you call the locale name constructor CultureInfo.CultureInfo, because locale names are preferable to LCIDs. Bei benutzerdefinierten Gebietsschemas ist der Name eines Gebietsschemas erforderlich.For custom locales, a locale name is required.

Der Benutzer möglicherweise zum Überschreiben einiger der aktuellen Kultur von Windows über die Regions- und spracheinstellungen des Teils der Optionen der Systemsteuerung zugeordneten Werte auswählen.The user might choose to override some of the values associated with the current culture of Windows through the regional and language options portion of Control Panel. Der Benutzer könnte z. B. zum Anzeigen des Datums in einem anderen Format oder keine andere als die Standardeinstellung für die Kultur zu verwenden.For example, the user might choose to display the date in a different format or to use a currency other than the default for the culture.

Anwendungen sollten die überschreibungen in der Regel nicht unterbinden.Applications should typically not disallow user overrides. Beachten Sie, dass untersagen von Außerkraftsetzungen nicht selbst Datenstabilität garantiert; finden Sie im Blogeintrag Kultur sollte nicht als (mit Ausnahme von invarianten) stabil betrachtet werden.Note that disallowing overrides does not itself guarantee data stability; see the blog entry Culture data shouldn't be considered stable (except for Invariant).

Wenn die UseUserOverride -Eigenschaftensatz auf true und der angegebenen Kulturbezeichner entspricht dem Bezeichner für die aktuelle Windows-Kultur, dieser Konstruktor erstellt ein CultureInfo , verwendet diese Außerkraftsetzungen, einschließlich der benutzereinstellungen für die Eigenschaften für von der DateTimeFormatInfo vom zurückgegebene Instanz der DateTimeFormat -Eigenschaft und die Eigenschaften von der NumberFormatInfo vom zurückgegebene Instanz der NumberFormat Eigenschaft.If the UseUserOverride property is set to true and the specified culture identifier matches the identifier of the current Windows culture, this constructor creates a CultureInfo that uses those overrides, including user settings for the properties of the DateTimeFormatInfo instance returned by the DateTimeFormat property, and the properties of the NumberFormatInfo instance returned by the NumberFormat property. Wenn die benutzereinstellungen nicht kompatibel mit der Kultur zugeordnet sind die CultureInfo, z. B. wenn einer der nicht der ausgewählte Kalender ist der OptionalCalendars, die Ergebnisse der Methoden und die Werte der Eigenschaften sind nicht definiert.If the user settings are incompatible with the culture associated with the CultureInfo, for example, if the selected calendar is not one of the OptionalCalendars, the results of the methods and the values of the properties are undefined.

Dieser Konstruktor erstellt andernfalls einen CultureInfo , die die Standardwerte für die angegebene Kultur verwendet.Otherwise, this constructor creates a CultureInfo that uses the default values for the specified culture.

Der Wert des der useUserOverride -Parameter wird der Wert, der die UseUserOverride Eigenschaft.The value of the useUserOverride parameter becomes the value of the UseUserOverride property.

Nehmen wir beispielsweise an, dass Arabisch (Saudi-Arabien) die aktuelle Kultur von Windows ist und der Benutzer hat den Kalender von Hijri gregorianische geändert.For example, suppose that Arabic (Saudi Arabia) is the current culture of Windows and the user has changed the calendar from Hijri to Gregorian.

Für die Kulturen, die mit den Euro, wird .NET Framework und Windows XP standardmäßig Währung als Euro festlegen.For cultures that use the euro, the .NET Framework and Windows XP set the default currency as euro. Werden jedoch in ältere Versionen von Windows nicht.However, older versions of Windows do not. Wenn der Benutzer eine ältere Version von Windows nicht die Einstellung "Währung" über die Regions- und spracheinstellungen des Teils der Optionen der Systemsteuerung geändert hat, kann die Währung aus diesem Grund falsch sein.Therefore, if the user of an older version of Windows has not changed the currency setting through the regional and language options portion of Control Panel, the currency might be incorrect. Um die .NET Framework-Standardeinstellung für die Währung zu verwenden, die Anwendung festlegen, sollten die useUserOverride Parameter false.To use the .NET Framework default setting for the currency, the application should set the useUserOverride parameter to false.

Hinweis

Für Abwärtskompatibilität einer Kultur mithilfe einer culture Parameter 0 x 0004 oder 0x7c04 besitzen, wird eine Name Eigenschaft Zh-CHS oder Zh-CHT bzw.For backwards compatibility, a culture constructed using a culture parameter of 0x0004 or 0x7c04 will have a Name property of zh-CHS or zh-CHT, respectively. Sie sollten stattdessen lieber die Kultur, die über die aktuellen Namen der Standardkultur des Zh-Hans oder Zh-Hant, erstellen, wenn Sie einen Grund für die Verwendung der älteren Namen haben.You should instead prefer to construct the culture using the current standard culture names of zh-Hans or zh-Hant, unless you have a reason for using the older names.

Hinweise für Aufrufer

Die .NET Framework 3,5.NET Framework 3.5 und frühere Versionen lösen eine ArgumentException Wenn culture ist kein gültiger Kulturbezeichner.The .NET Framework 3,5.NET Framework 3.5 and earlier versions throw an ArgumentException if culture is not a valid culture identifier. Beginnend mit der .NET Framework 4.NET Framework 4, löst der Konstruktor eine CultureNotFoundException.Starting with the .NET Framework 4.NET Framework 4, this constructor throws a CultureNotFoundException. Beginnend mit apps, die unter ausgeführt der .NET Framework 4.NET Framework 4 oder höher unter Windows 7 oder höher, die Methode versucht, zum Abrufen einer CultureInfo Objekt, dessen Bezeichner culture vom Betriebssystem; Wenn das Betriebssystem, Kultur, nicht unterstützt die -Methode löst eine CultureNotFoundException Ausnahme.Starting with apps that run under the .NET Framework 4.NET Framework 4 or later on Windows 7 or later, the method attempts to retrieve a CultureInfo object whose identifier is culture from the operating system; if the operating system does not support that culture, the method throws a CultureNotFoundException exception.

Siehe auch

CultureInfo(String, Boolean) CultureInfo(String, Boolean) CultureInfo(String, Boolean) CultureInfo(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.Initializes a new instance of the CultureInfo class based on the culture specified by name and on the Boolean that specifies whether to use the user-selected culture settings from the system.

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

name
String String String String

Ein vordefinierter CultureInfo-Name, eine Name-Eigenschaft einer vorhandenen CultureInfo-Klasse oder ein nur für Windows definierter Kulturname.A predefined CultureInfo name, Name of an existing CultureInfo, or Windows-only culture name. Bei name wird nicht zwischen Groß- und Kleinschreibung unterschieden.name is not case-sensitive.

useUserOverride
Boolean Boolean Boolean Boolean

Ein boolescher Wert, der angibt, ob die vom Benutzer ausgewählten Kultureinstellungen verwendet werden sollen (true) oder ob die Standardkultureinstellungen verwendet werden (false).A Boolean that denotes whether to use the user-selected culture settings (true) or the default culture settings (false).

Ausnahmen

name ist kein gültiger Kulturname.name is not a valid culture name. Weitere Informationen finden Sie im Abschnitt „Hinweise zu Aufrufern“.See the Notes to Callers section for more information.

Hinweise

Eine Liste von vordefinierten Kulturnamen finden Sie in der National Language Support (NLS) API-Referenz am Go Global Developer Center.For a list of predefined culture names, see the National Language Support (NLS) API Reference at the Go Global Developer Center. Darüber hinaus beginnend mit Windows 10, name möglich, dass alle gültigen BCP-47-Sprachtag.In addition, starting with Windows 10, name can be any valid BCP-47 language tag.

Wenn name ist String.Empty, der Konstruktor erstellt eine Instanz der invarianten Kultur; Dies entspricht dem Abrufen des Werts der InvariantCulture Eigenschaft.If name is String.Empty, the constructor creates an instance of the invariant culture; this is equivalent to retrieving the value of the InvariantCulture property.

Der Benutzer möglicherweise zum Überschreiben einiger der aktuellen Kultur von Windows über die Regions- und spracheinstellungen des Teils der Optionen der Systemsteuerung zugeordneten Werte auswählen.The user might choose to override some of the values associated with the current Windows culture through the regional and language options portion of Control Panel. Der Benutzer könnte z. B. zum Anzeigen des Datums in einem anderen Format oder keine andere als die Standardeinstellung für die Kultur zu verwenden.For example, the user might choose to display the date in a different format or to use a currency other than the default for the culture.

Anwendungen sollten die überschreibungen in der Regel nicht unterbinden.Applications should typically not disallow user overrides. Beachten Sie, dass untersagen von Außerkraftsetzungen nicht selbst Datenstabilität garantiert; finden Sie im Blogeintrag Kultur sollte nicht als (mit Ausnahme von invarianten) stabil betrachtet werden.Note that disallowing overrides does not itself guarantee data stability; see the blog entry Culture data shouldn't be considered stable (except for Invariant).

Wenn die UseUserOverride -Eigenschaftensatz auf true und der Namen der angegebenen Kultur zugeordnete Kulturbezeichner entspricht den Kulturbezeichner für die aktuelle Windows-Kultur, dieser Konstruktor erstellt ein CultureInfo , verwendet diese Außerkraftsetzungen einschließlich der Einstellungen für die Eigenschaften des Benutzers der DateTimeFormatInfo vom zurückgegebene Instanz der DateTimeFormat -Eigenschaft, und die Eigenschaften der NumberFormatInfo vom zurückgegebene Instanz der NumberFormat Eigenschaft.If the UseUserOverride property is set to true and the culture identifier associated with the specified culture name matches the culture identifier of the current Windows culture, this constructor creates a CultureInfo that uses those overrides, including user settings for the properties of the DateTimeFormatInfo instance returned by the DateTimeFormat property, and the properties of the NumberFormatInfo instance returned by the NumberFormat property. Wenn die benutzereinstellungen nicht kompatibel mit der Kultur zugeordnet sind die CultureInfo, z. B. wenn einer der nicht der ausgewählte Kalender ist der OptionalCalendars, die Ergebnisse der Methoden und die Werte der Eigenschaften sind nicht definiert.If the user settings are incompatible with the culture associated with the CultureInfo, for example, if the selected calendar is not one of the OptionalCalendars, the results of the methods and the values of the properties are undefined.

Dieser Konstruktor erstellt andernfalls einen CultureInfo , die die Standardwerte für die angegebene Kultur verwendet.Otherwise, this constructor creates a CultureInfo that uses the default values for the specified culture.

Der Wert des der useUserOverride -Parameter wird der Wert, der die UseUserOverride Eigenschaft.The value of the useUserOverride parameter becomes the value of the UseUserOverride property.

Nehmen wir beispielsweise an, dass Arabisch (Saudi-Arabien) die aktuelle Kultur von Windows ist und der Benutzer in den gregorianischen Kalender von Hijri geändert.For example, suppose that Arabic (Saudi Arabia) is the current culture of Windows and the user changed the calendar from Hijri to Gregorian.

Die LCID -Eigenschaft des neuen CultureInfo festgelegt ist, auf die Kultur-ID, die dem angegebenen Namen zugeordnet.The LCID property of the new CultureInfo is set to the culture identifier associated with the specified name.

Für die Kulturen, die mit den Euro, wird .NET Framework und Windows XP standardmäßig Währung als Euro festlegen.For cultures that use the euro, the .NET Framework and Windows XP set the default currency as euro. Jedoch tun ältere Versionen von Windows nicht dies.However, older versions of Windows do not do this. Wenn der Benutzer eine ältere Version von Windows nicht die Einstellung "Währung" über die Regions- und spracheinstellungen des Teils der Optionen der Systemsteuerung geändert hat, kann die Währung aus diesem Grund falsch sein.Therefore, if the user of an older version of Windows has not changed the currency setting through the regional and language options portion of Control Panel, the currency might be incorrect. Um die .NET Framework-Standardeinstellung für die Währung zu verwenden, die Anwendung festlegen, sollten die useUserOverride Parameter false.To use the .NET Framework default setting for the currency, the application should set the useUserOverride parameter to false.

Hinweise für Aufrufer

Die .NET Framework 3,5.NET Framework 3.5 und frühere Versionen lösen eine ArgumentException Wenn name ist kein gültiger Kulturname.The .NET Framework 3,5.NET Framework 3.5 and earlier versions throw an ArgumentException if name is not a valid culture name. Beginnend mit der .NET Framework 4.NET Framework 4, löst der Konstruktor eine CultureNotFoundException.Starting with the .NET Framework 4.NET Framework 4, this constructor throws a CultureNotFoundException. Beginnend mit apps, die unter ausgeführt der .NET Framework 4.NET Framework 4 oder höher unter Windows 7 oder höher, die Methode versucht, Abrufen einer CultureInfo Objekt, dessen Bezeichner name vom Betriebssystem; Wenn das Betriebssystem diese Kultur nicht unterstützt und name ist nicht der Name einer Kultur zusätzliche oder ersetzt die löst die Methode eine CultureNotFoundException Ausnahme.Starting with apps that run under the .NET Framework 4.NET Framework 4 or later on Windows 7 or later, the method attempts to retrieve a CultureInfo object whose identifier is name from the operating system; if the operating system does not support that culture, and if name is not the name of a supplementary or replacement culture, the method throws a CultureNotFoundException exception.

Siehe auch

Gilt für: