CultureInfo Konstruktoren

Definition

Initialisiert eine neue Instanz der CultureInfo-Klasse.Initializes a new instance of the CultureInfo class.

Überlädt

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)

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)

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)

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)

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

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 kleiner als Null.culture is less than zero.

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 Kultur Bezeichner für Kulturen, die unter Windows System verfügbar sind, sind in der Spalte Sprachtag in der Liste der von Windows unterstützten Sprachen/Regions Namenaufgelistet.Predefined culture identifiers for cultures available on Windows system are listed in the Language tag column in the list of language/region names supported by Windows. Kulturnamen befolgen den von BCP 47 definierten Standard.Culture names follow the standard defined by BCP 47.

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

Es wird empfohlen, den Namen des Gebiets Schema namens CultureInfo.CultureInfoaufzurufen, da Gebiets Schema Namen LCIDs vorzuziehen sind.We recommend that you call the locale name constructor CultureInfo.CultureInfo, because locale names are preferable to LCIDs. Bei benutzerdefinierten Gebiets Schemas ist ein Gebiets Schema Name erforderlich.For custom locales, a locale name is required.

Der Benutzer kann einige der Werte, die der aktuellen Kultur von Windows zugeordnet sind, über die Regions-und Sprachoptionen in der Systemsteuerung überschreiben.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. Beispielsweise kann der Benutzer das Datum in einem anderen Format anzeigen oder eine andere Währung als den Standardwert für die Kultur 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 angegebene Kultur Bezeichner mit dem Kultur Bezeichner der aktuellen Windows-Kultur übereinstimmt, erstellt dieser Konstruktor eine CultureInfo, die diese außer Kraft setzungen verwendet, einschließlich der Benutzereinstellungen für die Eigenschaften der DateTimeFormatInfo Instanz, die vom zurückgegeben werden DateTimeFormat -Eigenschaft und die Eigenschaften der NumberFormatInfo Instanz, die von der NumberFormat-Eigenschaft zurückgegeben wird.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 mit der Kultur, die der CultureInfo zugeordnet ist, nicht kompatibel sind (wenn der ausgewählte Kalender z. b. keiner der OptionalCalendarsist), sind die Ergebnisse der Methoden und die Werte der Eigenschaften 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 angegebene Kultur Bezeichner nicht mit dem Bezeichner der aktuellen Windows-Kultur identisch ist, erstellt dieser Konstruktor eine 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 den Kalender von Hijri in Gregorianisch geändert hat.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 Kulturen, die den Euro verwenden, legen die .NET Framework und Windows XP die Standardwährung auf "Euro" fest.For cultures that use the euro, the .NET Framework and Windows XP set the default currency as euro. Ältere Versionen von Windows jedoch nicht.However, older versions of Windows do not. Wenn der Benutzer einer älteren Version von Windows die Währungs Einstellung nicht über den Regions-und Sprachoptionen Bereich der Systemsteuerung geändert hat, ist die Währung daher möglicherweise falsch.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 eine CultureInfo-Konstruktorüberladung verwenden, die einen useUserOverride-Parameter akzeptiert und auf falsefestlegt.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 die Kultur mithilfe der aktuellen Standard Kultur Namen von zh-Hans oder zh-Hant erstellen, es sei denn, Sie haben einen Grund für die Verwendung der älteren Namen.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

Der .NET Framework 3,5.NET Framework 3.5 und frühere Versionen lösen eine ArgumentException aus, wenn culture kein gültiger Kultur Bezeichner ist.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 dem .NET Framework 4.NET Framework 4löst dieser Konstruktor eine CultureNotFoundExceptionaus.Starting with the .NET Framework 4.NET Framework 4, this constructor throws a CultureNotFoundException. Beginnend mit apps, die unter der .NET Framework 4.NET Framework 4 oder höher unter Windows 7 oder höher ausgeführt werden, versucht die Methode, ein CultureInfo Objekt abzurufen, dessen Bezeichner vom Betriebssystem culture wird. Wenn diese Kultur vom Betriebssystem nicht unterstützt wird, löst die Methode eine CultureNotFoundException Ausnahme aus.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)

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

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 NULL.name is null.

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 folgenden Beispiel wird die aktuelle Kultur abgerufen.The following example retrieves the current culture. Wenn es sich um einen anderen Wert als die Kultur Französisch (Frankreich) handelt, wird der CultureInfo(String)-Konstruktor aufgerufen, um ein CultureInfo Objekt zu instanziieren, das die Kultur Französisch (Frankreich) darstellt und es zur aktuellen Thread Kultur macht.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 instanziiert er ein CultureInfo Objekt, das die Kultur Französisch (Luxemburg) darstellt, und bildet es zur aktuellen 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 der vordefinierten Kultur Namen auf Windows-Systemen finden Sie in der Spalte sprach Kennzeichen in der Liste der von Windows unterstützten Sprachen/Regions Namen.For a list of predefined culture names on Windows systems, see the Language tag column in the list of language/region names supported by Windows. Kulturnamen befolgen den von BCP 47 definierten Standard.Culture names follow the standard defined by BCP 47. Außerdem kann name ab Windows 10 ein beliebiges gültiges bcp-47-Sprachtag sein.In addition, starting with Windows 10, name can be any valid BCP-47 language tag.

Wenn name String.Emptyist, erstellt der Konstruktor 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 kann einige der Werte, die der aktuellen Kultur von Windows zugeordnet sind, über die Regions-und Sprachoptionen in der Systemsteuerung überschreiben.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. Beispielsweise kann der Benutzer das Datum in einem anderen Format anzeigen oder eine andere Währung als den Standardwert für die Kultur 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 mit name verknüpfte Kultur Bezeichner mit dem Kultur Bezeichner der aktuellen Windows-Kultur übereinstimmt, erstellt dieser Konstruktor ein CultureInfo Objekt, das diese außer Kraft setzungen verwendet, einschließlich der Benutzereinstellungen für die Eigenschaften der DateTimeFormatInfo Instanz. wird von der DateTimeFormat-Eigenschaft und den Eigenschaften der NumberFormatInfo Instanz zurückgegeben, die von der NumberFormat-Eigenschaft zurückgegeben wird.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 mit der Kultur, die dem CultureInfozugeordnet ist, nicht kompatibel sind, z. b. wenn es sich bei dem ausgewählten Kalender nicht um einen der OptionalCalendarshandelt, sind die Ergebnisse der Methoden und die Werte der Eigenschaften 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 mit name verknüpfte Kultur Bezeichner nicht mit dem Kultur Bezeichner der aktuellen Windows-Kultur identisch ist, erstellt dieser Konstruktor 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 Windows-Kultur ist und der Benutzer den Kalender von Hijri in Gregorianisch geändert hat.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 der neuen CultureInfo wird auf den Kultur Bezeichner festgelegt, der dem angegebenen Namen zugeordnet ist.The LCID property of the new CultureInfo is set to the culture identifier associated with the specified name.

Für Kulturen, die den Euro verwenden, legen die .NET Framework und Windows XP die Standardwährung auf "Euro" fest.For cultures that use the euro, the .NET Framework and Windows XP set the default currency as euro. In älteren Versionen von Windows wird dies jedoch nicht der Fall sein.However, older versions of Windows do not do this. Wenn der Benutzer einer älteren Version von Windows die Währungs Einstellung nicht über den Regions-und Sprachoptionen Bereich der Systemsteuerung geändert hat, ist die Währung daher möglicherweise falsch.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 eine CultureInfo-Konstruktorüberladung verwenden, die einen useUserOverride-Parameter akzeptiert und auf falsefestlegt.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

In der .NET Framework 3,5.NET Framework 3.5 und früheren Versionen wird eine ArgumentException ausgelöst, wenn name kein gültiger Kultur Name ist.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 dem .NET Framework 4.NET Framework 4löst dieser Konstruktor eine CultureNotFoundExceptionaus.Starting with the .NET Framework 4.NET Framework 4, this constructor throws a CultureNotFoundException. Beginnend mit apps, die unter der .NET Framework 4.NET Framework 4 oder höher unter Windows 7 oder höher ausgeführt werden, versucht die Methode, ein CultureInfo Objekt abzurufen, dessen Bezeichner vom Betriebssystem name wird. Wenn diese Kultur vom Betriebssystem nicht unterstützt wird und name nicht der Name einer ergänzenden oder Ersatz Kultur ist, löst die Methode eine CultureNotFoundException Ausnahme aus.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)

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

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

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 kleiner als Null.culture is less than zero.

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 Kultur Bezeichner, die auf Windows-Systemen verfügbar sind, sind in der Spalte Sprachtag in der Liste der von Windows unterstützten Sprachen/Regions Namenaufgelistet.Predefined culture identifiers available on Windows systems are listed in the Language tag column in the list of language/region names supported by Windows. Kulturnamen befolgen den von BCP 47 definierten Standard.Culture names follow the standard defined by BCP 47.

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

Es wird empfohlen, den Namen des Gebiets Schema namens CultureInfo.CultureInfoaufzurufen, da Gebiets Schema Namen LCIDs vorzuziehen sind.We recommend that you call the locale name constructor CultureInfo.CultureInfo, because locale names are preferable to LCIDs. Bei benutzerdefinierten Gebiets Schemas ist ein Gebiets Schema Name erforderlich.For custom locales, a locale name is required.

Der Benutzer kann einige der Werte, die der aktuellen Kultur von Windows zugeordnet sind, über die Regions-und Sprachoptionen in der Systemsteuerung überschreiben.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. Beispielsweise kann der Benutzer das Datum in einem anderen Format anzeigen oder eine andere Währung als den Standardwert für die Kultur 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 Benutzer Überschreibungen in der Regel nicht zulassen.Applications should typically not disallow user overrides. Beachten Sie, dass das Zulassen von außer Kraft setzungen nicht selbst die Daten Stabilität garantiert. Siehe Blogeintrag Kultur Daten sollten nicht als stabil eingestuft werden (außer invariant).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-Eigenschaft auf true festgelegt ist und der angegebene Kultur Bezeichner mit dem Bezeichner der aktuellen Windows-Kultur übereinstimmt, erstellt dieser Konstruktor eine CultureInfo, die diese außer Kraft setzungen verwendet, einschließlich der Benutzereinstellungen für die Eigenschaften des DateTimeFormatInfo Instanz, die von der DateTimeFormat-Eigenschaft zurückgegeben wird, und die Eigenschaften der von der NumberFormat-Eigenschaft zurückgegebenen NumberFormatInfo Instanz.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 mit der Kultur, die dem CultureInfozugeordnet ist, nicht kompatibel sind, z. b. wenn es sich bei dem ausgewählten Kalender nicht um einen der OptionalCalendarshandelt, sind die Ergebnisse der Methoden und die Werte der Eigenschaften 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.

Andernfalls erstellt dieser Konstruktor eine 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 useUserOverride-Parameters wird zum Wert der UseUserOverride-Eigenschaft.The value of the useUserOverride parameter becomes the value of the UseUserOverride property.

Angenommen, Arabisch (Saudi-Arabien) ist die aktuelle Kultur von Windows, und der Benutzer hat den Kalender von Hijri in Gregorianisch 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 Kulturen, die den Euro verwenden, legen die .NET Framework und Windows XP die Standardwährung auf "Euro" fest.For cultures that use the euro, the .NET Framework and Windows XP set the default currency as euro. Ältere Versionen von Windows jedoch nicht.However, older versions of Windows do not. Wenn der Benutzer einer älteren Version von Windows die Währungs Einstellung nicht über den Regions-und Sprachoptionen Bereich der Systemsteuerung geändert hat, ist die Währung daher möglicherweise falsch.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 den useUserOverride-Parameter auf falsefestlegen.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 die Kultur mithilfe der aktuellen Standard Kultur Namen von zh-Hans oder zh-Hant erstellen, es sei denn, Sie haben einen Grund für die Verwendung der älteren Namen.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

Der .NET Framework 3,5.NET Framework 3.5 und frühere Versionen lösen eine ArgumentException aus, wenn culture kein gültiger Kultur Bezeichner ist.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 dem .NET Framework 4.NET Framework 4löst dieser Konstruktor eine CultureNotFoundExceptionaus.Starting with the .NET Framework 4.NET Framework 4, this constructor throws a CultureNotFoundException. Beginnend mit apps, die unter der .NET Framework 4.NET Framework 4 oder höher unter Windows 7 oder höher ausgeführt werden, versucht die Methode, ein CultureInfo Objekt abzurufen, dessen Bezeichner vom Betriebssystem culture wird. Wenn diese Kultur vom Betriebssystem nicht unterstützt wird, löst die Methode eine CultureNotFoundException Ausnahme aus.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)

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

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

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 NULL.name is null.

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 der vordefinierten Kultur Namen finden Sie in der Spalte Sprachtag in der Liste der von Windows unterstützten Sprachen/Regions Namen.For a list of predefined culture names, see the Language tag column in the list of language/region names supported by Windows. Kulturnamen befolgen den von BCP 47 definierten Standard.Culture names follow the standard defined by BCP 47. Außerdem kann name ab Windows 10 ein beliebiges gültiges bcp-47-Sprachtag sein.In addition, starting with Windows 10, name can be any valid BCP-47 language tag.

Wenn name String.Emptyist, erstellt der Konstruktor 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 kann einige der Werte, die mit der aktuellen Windows-Kultur verknüpft sind, über die Regions-und Sprachoptionen in der Systemsteuerung überschreiben.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. Beispielsweise kann der Benutzer das Datum in einem anderen Format anzeigen oder eine andere Währung als den Standardwert für die Kultur 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 Benutzer Überschreibungen in der Regel nicht zulassen.Applications should typically not disallow user overrides. Beachten Sie, dass das Zulassen von außer Kraft setzungen nicht selbst die Daten Stabilität garantiert. Siehe Blogeintrag Kultur Daten sollten nicht als stabil eingestuft werden (außer invariant).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-Eigenschaft auf true festgelegt ist und der mit dem angegebenen Kultur Namen verknüpfte Kultur Bezeichner mit dem Kultur Bezeichner der aktuellen Windows-Kultur übereinstimmt, erstellt dieser Konstruktor eine CultureInfo, die diese außer Kraft setzungen verwendet, einschließlich des Benutzers. Einstellungen für die Eigenschaften der DateTimeFormatInfo Instanz, die von der DateTimeFormat-Eigenschaft zurückgegeben werden, und die Eigenschaften der NumberFormatInfo Instanz, die von der NumberFormat-Eigenschaft zurückgegeben wird.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 mit der Kultur, die dem CultureInfozugeordnet ist, nicht kompatibel sind, z. b. wenn es sich bei dem ausgewählten Kalender nicht um einen der OptionalCalendarshandelt, sind die Ergebnisse der Methoden und die Werte der Eigenschaften 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.

Andernfalls erstellt dieser Konstruktor eine 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 useUserOverride-Parameters wird zum Wert der 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 Windows-Kultur ist und der Benutzer den Kalender von Hijri in Gregorianisch geändert hat.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 der neuen CultureInfo wird auf den Kultur Bezeichner festgelegt, der dem angegebenen Namen zugeordnet ist.The LCID property of the new CultureInfo is set to the culture identifier associated with the specified name.

Für Kulturen, die den Euro verwenden, legen die .NET Framework und Windows XP die Standardwährung auf "Euro" fest.For cultures that use the euro, the .NET Framework and Windows XP set the default currency as euro. In älteren Versionen von Windows wird dies jedoch nicht der Fall sein.However, older versions of Windows do not do this. Wenn der Benutzer einer älteren Version von Windows die Währungs Einstellung nicht über den Regions-und Sprachoptionen Bereich der Systemsteuerung geändert hat, ist die Währung daher möglicherweise falsch.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 den useUserOverride-Parameter auf falsefestlegen.To use the .NET Framework default setting for the currency, the application should set the useUserOverride parameter to false.

Hinweise für Aufrufer

In der .NET Framework 3,5.NET Framework 3.5 und früheren Versionen wird eine ArgumentException ausgelöst, wenn name kein gültiger Kultur Name ist.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 dem .NET Framework 4.NET Framework 4löst dieser Konstruktor eine CultureNotFoundExceptionaus.Starting with the .NET Framework 4.NET Framework 4, this constructor throws a CultureNotFoundException. Beginnend mit apps, die unter der .NET Framework 4.NET Framework 4 oder höher unter Windows 7 oder höher ausgeführt werden, versucht die Methode, ein CultureInfo Objekt abzurufen, dessen Bezeichner vom Betriebssystem name wird. Wenn diese Kultur vom Betriebssystem nicht unterstützt wird und name nicht der Name einer ergänzenden oder Ersatz Kultur ist, löst die Methode eine CultureNotFoundException Ausnahme aus.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: