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, dass Sie den Konstruktor für den Gebiets Schema Namen aufzurufen CultureInfo.CultureInfo , 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 einen, der CultureInfo diese über schreibungen verwendet, einschließlich der Benutzereinstellungen für die Eigenschaften der DateTimeFormatInfo Instanz, die von der-Eigenschaft zurückgegeben DateTimeFormat wird, und der Eigenschaften der Instanz, die NumberFormatInfo von der-Eigenschaft zurückgegeben NumberFormat wirdIf 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 dem zugeordnet CultureInfo ist, nicht kompatibel sind (z. b. wenn der ausgewählte Kalender kein ist OptionalCalendars ), 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 festlegt 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 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

In .NET Framework 3.5.NET Framework 3.5 und früheren Versionen wird ein ausgelöst, ArgumentException 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. Ab löst .NET Framework 4.NET Framework 4 dieser Konstruktor einen aus CultureNotFoundException .Starting with the .NET Framework 4.NET Framework 4, this constructor throws a CultureNotFoundException. Beginnend mit apps, die unter oder höher unter .NET Framework 4.NET Framework 4 Windows 7 oder höher ausgeführt werden, versucht die-Methode, ein-Objekt abzurufen, CultureInfo dessen Bezeichner culture vom Betriebssystem ist. wenn das Betriebssystem diese Kultur nicht unterstützt, 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.

Weitere Informationen

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-Objekt zu instanziieren, CultureInfo 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 wird ein-Objekt instanziiert CultureInfo , das die Kultur Französisch (Luxemburg) darstellt und die aktuelle Kultur darstellt.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 ab Windows 10 name 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 ist String.Empty , 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 der Kultur Bezeichner name , der zugeordnet ist, 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, die von der-Eigenschaft zurückgegeben DateTimeFormat wird, und der Eigenschaften der NumberFormatInfo von der- NumberFormat EigenschaftIf 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 zugeordnet ist, nicht kompatibel sind, Beispiels CultureInfo Weise wenn der ausgewählte Kalender nicht zu gehört, OptionalCalendars 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 der Kultur Bezeichner, der zugeordnet ist name , 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 festlegt 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

In .NET Framework 3.5.NET Framework 3.5 und früheren Versionen wird ein ausgelöst, ArgumentException 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. Ab löst .NET Framework 4.NET Framework 4 dieser Konstruktor einen aus CultureNotFoundException .Starting with the .NET Framework 4.NET Framework 4, this constructor throws a CultureNotFoundException. Beginnend mit apps, die unter oder höher unter .NET Framework 4.NET Framework 4 Windows 7 oder höher ausgeführt werden, versucht die-Methode, ein-Objekt abzurufen, CultureInfo dessen Bezeichner name vom Betriebssystem verwendet wird. wenn das Betriebssystem diese Kultur nicht unterstützt, und wenn 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.

Weitere Informationen

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, dass Sie den Konstruktor für den Gebiets Schema Namen aufzurufen CultureInfo.CultureInfo , 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 festgelegt ist true und der angegebene Kultur Bezeichner mit dem Bezeichner der aktuellen Windows-Kultur übereinstimmt, erstellt dieser Konstruktor einen, CultureInfo der diese über schreibungen verwendet, einschließlich der Benutzereinstellungen für die Eigenschaften der- DateTimeFormatInfo Instanz, die von der-Eigenschaft zurückgegeben DateTimeFormat wird, und der Eigenschaften der-Instanz, die NumberFormatInfo von der- NumberFormat EigenschaftIf 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 zugeordnet ist, nicht kompatibel sind, Beispiels CultureInfo Weise wenn der ausgewählte Kalender nicht zu gehört, OptionalCalendars 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 einen CultureInfo , der 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 festlegen 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 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

In .NET Framework 3.5.NET Framework 3.5 und früheren Versionen wird ein ausgelöst, ArgumentException 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. Ab löst .NET Framework 4.NET Framework 4 dieser Konstruktor einen aus CultureNotFoundException .Starting with the .NET Framework 4.NET Framework 4, this constructor throws a CultureNotFoundException. Beginnend mit apps, die unter oder höher unter .NET Framework 4.NET Framework 4 Windows 7 oder höher ausgeführt werden, versucht die-Methode, ein-Objekt abzurufen, CultureInfo dessen Bezeichner culture vom Betriebssystem ist. wenn das Betriebssystem diese Kultur nicht unterstützt, 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.

Weitere Informationen

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 ab Windows 10 name 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 ist String.Empty , 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 festgelegt ist true und der Kultur Bezeichner, der dem angegebenen Kultur Namen zugeordnet ist, mit dem Kultur Bezeichner der aktuellen Windows-Kultur übereinstimmt, erstellt dieser Konstruktor einen, CultureInfo der diese über schreibungen verwendet, einschließlich der Benutzereinstellungen für die Eigenschaften der DateTimeFormatInfo Instanz, die von der DateTimeFormat -Eigenschaft zurückgegeben wird, und der Eigenschaften der Instanz, die NumberFormatInfo von der- NumberFormat EigenschaftIf 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 zugeordnet ist, nicht kompatibel sind, Beispiels CultureInfo Weise wenn der ausgewählte Kalender nicht zu gehört, OptionalCalendars 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 einen CultureInfo , der 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 festlegen false .To use the .NET Framework default setting for the currency, the application should set the useUserOverride parameter to false.

Hinweise für Aufrufer

In .NET Framework 3.5.NET Framework 3.5 und früheren Versionen wird ein ausgelöst, ArgumentException 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. Ab löst .NET Framework 4.NET Framework 4 dieser Konstruktor einen aus CultureNotFoundException .Starting with the .NET Framework 4.NET Framework 4, this constructor throws a CultureNotFoundException. Beginnend mit apps, die unter oder höher unter .NET Framework 4.NET Framework 4 Windows 7 oder höher ausgeführt werden, versucht die-Methode, ein-Objekt abzurufen, CultureInfo dessen Bezeichner name vom Betriebssystem verwendet wird. wenn das Betriebssystem diese Kultur nicht unterstützt, und wenn 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.

Weitere Informationen

Gilt für: