CultureInfo Konstruktory

Definice

Initializes a new instance of the CultureInfo class.Initializes a new instance of the CultureInfo class.

Přetížení

CultureInfo(Int32)

Initializes a new instance of the CultureInfo class based on the culture specified by the culture identifier.Initializes a new instance of the CultureInfo class based on the culture specified by the culture identifier.

CultureInfo(String)

Inicializuje novou instanci třídy CultureInfo založenou na jazykové verzi určené názvem.Initializes a new instance of the CultureInfo class based on the culture specified by name.

CultureInfo(Int32, Boolean)

Inicializuje novou instanci třídy CultureInfo založenou na jazykové verzi určené identifikátorem jazykové verze a na logickém serveru, který určuje, zda se má v systému použít nastavení jazykové verze vybrané uživatelem.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)

Inicializuje novou instanci třídy CultureInfo založenou na jazykové verzi určené názvem a na logickém počítači, která určuje, zda se má v systému použít nastavení jazykové verze vybrané uživatelem.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)

Initializes a new instance of the CultureInfo class based on the culture specified by the culture identifier.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)

Parametry

culture
Int32

Předdefinovaný CultureInfo identifikátor, LCID vlastnost existujícího CultureInfo objektu nebo identifikátor jazykové verze pouze Windows.A predefined CultureInfo identifier, LCID property of an existing CultureInfo object, or Windows-only culture identifier.

Výjimky

culture je menší než nula.culture is less than zero.

culture není platný identifikátor jazykové verze.culture is not a valid culture identifier. Další informace najdete v části poznámky k volajícím.See the Notes to Callers section for more information.

Poznámky

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.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. Názvy jazykové verze se řídí standardem definovaným v BCP 47.Culture names follow the standard defined by BCP 47.

Ve většině případů je parametr culture namapovaný na odpovídající identifikátor národního prostředí (NLS) národní jazykové podpory (NLS).In most cases, the culture parameter is mapped to the corresponding National Language Support (NLS) locale identifier. Hodnota parametru culture se zobrazí jako hodnota vlastnosti LCID nového CultureInfo.The value of the culture parameter becomes the value of the LCID property of the new CultureInfo.

Doporučujeme, abyste volali CultureInfo.CultureInfokonstruktoru názvu národního prostředí, protože názvy národních prostředí jsou vhodnější pro LCID.We recommend that you call the locale name constructor CultureInfo.CultureInfo, because locale names are preferable to LCIDs. Pro vlastní národní prostředí se vyžaduje název národního prostředí.For custom locales, a locale name is required.

Uživatel se může rozhodnout přepsat některé hodnoty přidružené k aktuální jazykové verzi Windows prostřednictvím části místní a jazykové nastavení v Ovládacích panelech.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. Uživatel se například může rozhodnout zobrazit datum v jiném formátu nebo použít jinou než výchozí měnu pro jazykovou verzi.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. Pokud zadaný identifikátor jazykové verze odpovídá identifikátoru jazykové verze aktuální jazykové verze systému Windows, tento konstruktor vytvoří CultureInfo, který používá tato přepsání, včetně uživatelských nastavení pro vlastnosti DateTimeFormatInfo instance vrácené DateTimeFormat vlastnost a vlastnosti instance NumberFormatInfo vrácené vlastností NumberFormat.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. Pokud je nastavení uživatele nekompatibilní s jazykovou verzí přidruženou k CultureInfo (například pokud vybraný kalendář není jedním z OptionalCalendars) výsledky metod a hodnoty vlastností nejsou definovány.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.

Pokud zadaný identifikátor jazykové verze neodpovídá identifikátoru aktuální jazykové verze systému Windows, tento konstruktor vytvoří CultureInfo, který používá výchozí hodnoty pro zadanou jazykovou verzi.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.

Vlastnost UseUserOverride je vždy nastavena na hodnotu true.The UseUserOverride property is always set to true.

Předpokládejme například, že Arabština (Saúdská Arábie) je aktuální jazyková verze systému Windows a uživatel změnil kalendář z kalendáře hidžra na gregoriánský.For example, suppose that Arabic (Saudi Arabia) is the current Windows culture and the user has changed the calendar from Hijri to Gregorian.

Pro jazykové verze, které používají euro, .NET Framework a Windows XP nastaví výchozí měnu jako euro.For cultures that use the euro, the .NET Framework and Windows XP set the default currency as euro. Starší verze Windows ale ne.However, older versions of Windows do not. 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.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. Chcete-li použít výchozí nastavení .NET Framework pro měnu, aplikace by měla použít přetížení konstruktoru CultureInfo, které přijímá parametr useUserOverride a nastavit jej na 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.

Poznámka

V případě zpětné kompatibility má jazyková verze vytvořená pomocí parametru culture 0x0004 nebo 0x7c04 vlastnost Name zh-CHS nebo zh-CHT v uvedeném pořadí.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. Místo toho byste měli preferovat vytváření jazykové verze pomocí aktuální jazykové verze Standard pro zh-Hans nebo zh-Hant, pokud nemáte důvod pro použití starších názvů.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.

Poznámky pro volající

.NET Framework 3.5.NET Framework 3.5 a starší verze vyvolají ArgumentException, pokud culture není platný identifikátor jazykové verze.The .NET Framework 3.5.NET Framework 3.5 and earlier versions throw an ArgumentException if culture is not a valid culture identifier. Starting with the .NET Framework 4.NET Framework 4, this constructor throws a CultureNotFoundException.Starting with the .NET Framework 4.NET Framework 4, this constructor throws a CultureNotFoundException. Počínaje aplikacemi, které běží v .NET Framework 4.NET Framework 4 nebo novějším ve Windows 7 nebo novějším, se metoda pokusí načíst objekt CultureInfo, jehož identifikátor je culture z operačního systému. Pokud operační systém tuto jazykovou verzi nepodporuje, vyvolá metoda výjimku CultureNotFoundException.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.

Viz také

CultureInfo(String)

Inicializuje novou instanci třídy CultureInfo založenou na jazykové verzi určené názvem.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)

Parametry

name
String

Předdefinovaný CultureInfo název, Name existující CultureInfonebo název jazykové verze pouze pro systém Windows.A predefined CultureInfo name, Name of an existing CultureInfo, or Windows-only culture name. name nerozlišuje velká a malá písmena.name is not case-sensitive.

Výjimky

name is null.name is null.

name není platný název jazykové verze.name is not a valid culture name. Další informace najdete v části poznámky k volajícím.For more information, see the Notes to Callers section.

Příklady

Následující příklad načte aktuální jazykovou verzi.The following example retrieves the current culture. Pokud se jedná o jinou než francouzskou jazykovou verzi (Francie), zavolá konstruktor CultureInfo(String) pro vytvoření instance CultureInfoho objektu, který představuje jazykovou verzi francouzštiny (Francie) a převede ho na aktuální jazykovou verzi vlákna.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. V opačném případě vytvoří instanci objektu CultureInfo, který představuje jazykovou verzi francouzštiny (Lucembursko), a převede ji na aktuální jazykovou verzi.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

Poznámky

Seznam předdefinovaných názvů jazykové verze v systémech Windows naleznete ve sloupci značka jazyka v seznamu názvů jazyků nebo oblastí podporovaných systémem Windows.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. Názvy jazykové verze se řídí standardem definovaným v BCP 47.Culture names follow the standard defined by BCP 47. Kromě toho, počínaje Windows 10, name může být jakákoli platná značka jazyka BCP-47.In addition, starting with Windows 10, name can be any valid BCP-47 language tag.

Pokud je name String.Empty, vytvoří konstruktor instanci neutrální jazykové verze; To je ekvivalentní k načtení hodnoty vlastnosti InvariantCulture.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.

Uživatel se může rozhodnout přepsat některé hodnoty přidružené k aktuální jazykové verzi Windows prostřednictvím části místní a jazykové nastavení v Ovládacích panelech.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. Uživatel se například může rozhodnout zobrazit datum v jiném formátu nebo použít jinou než výchozí měnu pro jazykovou verzi.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. Pokud identifikátor jazykové verze přidružený k name odpovídá identifikátoru jazykové verze aktuální jazykové verze systému Windows, tento konstruktor vytvoří objekt CultureInfo, který používá tato přepsání, včetně uživatelských nastavení pro vlastnosti instance DateTimeFormatInfo vrácený vlastností DateTimeFormat a vlastnostmi instance NumberFormatInfo vrácené vlastností NumberFormat.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. 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.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.

Pokud identifikátor jazykové verze přidružený k name neodpovídá identifikátoru jazykové verze aktuální jazykové verze systému Windows, tento konstruktor vytvoří objekt CultureInfo, který používá výchozí hodnoty pro zadanou jazykovou verzi.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.

Vlastnost UseUserOverride je vždy nastavena na hodnotu true.The UseUserOverride property is always set to true.

Předpokládejme například, že Arabština (Saúdská Arábie) je aktuální jazyková verze systému Windows a uživatel změnil kalendář z kalendáře hidžra na gregoriánský.For example, suppose that Arabic (Saudi Arabia) is the current culture of Windows and the user changed the calendar from Hijri to Gregorian.

Vlastnost LCID nového CultureInfo je nastavena na identifikátor jazykové verze přidružený k zadanému názvu.The LCID property of the new CultureInfo is set to the culture identifier associated with the specified name.

Pro jazykové verze, které používají euro, .NET Framework a Windows XP nastaví výchozí měnu jako euro.For cultures that use the euro, the .NET Framework and Windows XP set the default currency as euro. Starší verze Windows to ale neudělá.However, older versions of Windows do not do this. 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.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. Chcete-li použít výchozí nastavení .NET Framework pro měnu, aplikace by měla použít přetížení konstruktoru CultureInfo, které přijímá parametr useUserOverride a nastavit jej na 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.

Poznámky pro volající

.NET Framework 3.5.NET Framework 3.5 a starší verze vyvolají ArgumentException, pokud name není platný název jazykové verze.The .NET Framework 3.5.NET Framework 3.5 and earlier versions throw an ArgumentException if name is not a valid culture name. Starting with the .NET Framework 4.NET Framework 4, this constructor throws a CultureNotFoundException.Starting with the .NET Framework 4.NET Framework 4, this constructor throws a CultureNotFoundException. Počínaje aplikacemi, které běží v .NET Framework 4.NET Framework 4 nebo novějším ve Windows 7 nebo novějším, se metoda pokusí načíst objekt CultureInfo, jehož identifikátor je name z operačního systému. Pokud operační systém tuto jazykovou verzi nepodporuje a pokud name není název doplňkové nebo nahrazující jazykové verze, vyvolá metoda výjimku CultureNotFoundException.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.

Viz také

CultureInfo(Int32, Boolean)

Inicializuje novou instanci třídy CultureInfo založenou na jazykové verzi určené identifikátorem jazykové verze a na logickém serveru, který určuje, zda se má v systému použít nastavení jazykové verze vybrané uživatelem.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)

Parametry

culture
Int32

Předdefinovaný CultureInfo identifikátor, LCID vlastnost existujícího CultureInfo objektu nebo identifikátor jazykové verze pouze Windows.A predefined CultureInfo identifier, LCID property of an existing CultureInfo object, or Windows-only culture identifier.

useUserOverride
Boolean

Logická hodnota, která označuje, zda se má použít nastavení vybrané jazykové verze (true) nebo výchozí nastavení jazykové verze (false).A Boolean that denotes whether to use the user-selected culture settings (true) or the default culture settings (false).

Výjimky

culture je menší než nula.culture is less than zero.

culture není platný identifikátor jazykové verze.culture is not a valid culture identifier. Další informace najdete v části poznámky k volajícím.See the Notes to Callers section for more information.

Poznámky

Předdefinované identifikátory jazykové verze, které jsou k dispozici v systémech Windows, jsou uvedeny ve sloupci značka jazyka v seznamu názvů jazyků nebo oblastí podporovaných systémem Windows.Predefined culture identifiers available on Windows systems are listed in the Language tag column in the list of language/region names supported by Windows. Názvy jazykové verze se řídí standardem definovaným v BCP 47.Culture names follow the standard defined by BCP 47.

Ve většině případů je parametr culture namapovaný na odpovídající identifikátor národního prostředí (NLS) národní jazykové podpory (NLS).In most cases, the culture parameter is mapped to the corresponding National Language Support (NLS) locale identifier. Hodnota parametru culture se zobrazí jako hodnota vlastnosti LCID nového CultureInfo.The value of the culture parameter becomes the value of the LCID property of the new CultureInfo.

Doporučujeme, abyste volali CultureInfo.CultureInfokonstruktoru názvu národního prostředí, protože názvy národních prostředí jsou vhodnější pro LCID.We recommend that you call the locale name constructor CultureInfo.CultureInfo, because locale names are preferable to LCIDs. Pro vlastní národní prostředí se vyžaduje název národního prostředí.For custom locales, a locale name is required.

Uživatel se může rozhodnout přepsat některé hodnoty přidružené k aktuální jazykové verzi Windows prostřednictvím části místní a jazykové nastavení v Ovládacích panelech.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. Uživatel se například může rozhodnout zobrazit datum v jiném formátu nebo použít jinou než výchozí měnu pro jazykovou verzi.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.

Aplikace by obvykle neměly zakázat přepsání uživatelů.Applications should typically not disallow user overrides. Všimněte si, že nepovolené přepisy samy o sobě nezaručují stabilitu dat; Podívejte se, že data jazykové verze položky blogu by se neměla považovat za stabilní (kromě neutrálních).Note that disallowing overrides does not itself guarantee data stability; see the blog entry Culture data shouldn't be considered stable (except for Invariant).

Je-li vlastnost UseUserOverride nastavena na hodnotu true a zadaný identifikátor jazykové verze odpovídá identifikátoru aktuální jazykové verze systému Windows, tento konstruktor vytvoří CultureInfo, který tato přepsání používá, včetně uživatelských nastavení pro vlastnosti DateTimeFormatInfo instance vrácená vlastností DateTimeFormat a vlastnosti instance NumberFormatInfo vrácené vlastností NumberFormat.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. 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.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.

V opačném případě tento konstruktor vytvoří CultureInfo, který používá výchozí hodnoty pro zadanou jazykovou verzi.Otherwise, this constructor creates a CultureInfo that uses the default values for the specified culture.

Hodnota parametru useUserOverride se zobrazí jako hodnota vlastnosti UseUserOverride.The value of the useUserOverride parameter becomes the value of the UseUserOverride property.

Předpokládejme například, že Arabština (Saúdská Arábie) je aktuální jazyková verze systému Windows a uživatel změnil kalendář z kalendáře hidžra na gregoriánský.For example, suppose that Arabic (Saudi Arabia) is the current culture of Windows and the user has changed the calendar from Hijri to Gregorian.

Pro jazykové verze, které používají euro, .NET Framework a Windows XP nastaví výchozí měnu jako euro.For cultures that use the euro, the .NET Framework and Windows XP set the default currency as euro. Starší verze Windows ale ne.However, older versions of Windows do not. 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.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. To use the .NET Framework default setting for the currency, the application should set the useUserOverride parameter to false.To use the .NET Framework default setting for the currency, the application should set the useUserOverride parameter to false.

Poznámka

V případě zpětné kompatibility má jazyková verze vytvořená pomocí parametru culture 0x0004 nebo 0x7c04 vlastnost Name zh-CHS nebo zh-CHT v uvedeném pořadí.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. Místo toho byste měli preferovat vytváření jazykové verze pomocí aktuální jazykové verze Standard pro zh-Hans nebo zh-Hant, pokud nemáte důvod pro použití starších názvů.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.

Poznámky pro volající

.NET Framework 3.5.NET Framework 3.5 a starší verze vyvolají ArgumentException, pokud culture není platný identifikátor jazykové verze.The .NET Framework 3.5.NET Framework 3.5 and earlier versions throw an ArgumentException if culture is not a valid culture identifier. Starting with the .NET Framework 4.NET Framework 4, this constructor throws a CultureNotFoundException.Starting with the .NET Framework 4.NET Framework 4, this constructor throws a CultureNotFoundException. Počínaje aplikacemi, které běží v .NET Framework 4.NET Framework 4 nebo novějším ve Windows 7 nebo novějším, se metoda pokusí načíst objekt CultureInfo, jehož identifikátor je culture z operačního systému. Pokud operační systém tuto jazykovou verzi nepodporuje, vyvolá metoda výjimku CultureNotFoundException.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.

Viz také

CultureInfo(String, Boolean)

Inicializuje novou instanci třídy CultureInfo založenou na jazykové verzi určené názvem a na logickém počítači, která určuje, zda se má v systému použít nastavení jazykové verze vybrané uživatelem.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)

Parametry

name
String

Předdefinovaný CultureInfo název, Name existující CultureInfonebo název jazykové verze pouze pro systém Windows.A predefined CultureInfo name, Name of an existing CultureInfo, or Windows-only culture name. name nerozlišuje velká a malá písmena.name is not case-sensitive.

useUserOverride
Boolean

Logická hodnota, která označuje, zda se má použít nastavení vybrané jazykové verze (true) nebo výchozí nastavení jazykové verze (false).A Boolean that denotes whether to use the user-selected culture settings (true) or the default culture settings (false).

Výjimky

name is null.name is null.

name není platný název jazykové verze.name is not a valid culture name. Další informace najdete v části poznámky k volajícím.See the Notes to Callers section for more information.

Poznámky

Seznam předdefinovaných názvů jazykové verze najdete ve sloupci značka jazyka v seznamu názvů jazyků nebo oblastí podporovaných systémem Windows.For a list of predefined culture names, see the Language tag column in the list of language/region names supported by Windows. Názvy jazykové verze se řídí standardem definovaným v BCP 47.Culture names follow the standard defined by BCP 47. Kromě toho, počínaje Windows 10, name může být jakákoli platná značka jazyka BCP-47.In addition, starting with Windows 10, name can be any valid BCP-47 language tag.

Pokud je name String.Empty, vytvoří konstruktor instanci neutrální jazykové verze; To je ekvivalentní k načtení hodnoty vlastnosti InvariantCulture.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.

Uživatel se může rozhodnout přepsat některé hodnoty přidružené k aktuální jazykové verzi systému Windows prostřednictvím části místní a jazykové nastavení v Ovládacích panelech.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. Uživatel se například může rozhodnout zobrazit datum v jiném formátu nebo použít jinou než výchozí měnu pro jazykovou verzi.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.

Aplikace by obvykle neměly zakázat přepsání uživatelů.Applications should typically not disallow user overrides. Všimněte si, že nepovolené přepisy samy o sobě nezaručují stabilitu dat; Podívejte se, že data jazykové verze položky blogu by se neměla považovat za stabilní (kromě neutrálních).Note that disallowing overrides does not itself guarantee data stability; see the blog entry Culture data shouldn't be considered stable (except for Invariant).

Pokud je vlastnost UseUserOverride nastavena na hodnotu true a identifikátor jazykové verze přidružený k určenému názvu jazykové verze odpovídá identifikátoru kultury aktuální jazykové verze systému Windows, tento konstruktor vytvoří CultureInfo, která používá tato přepsání, včetně uživatele. nastavení vlastností instance DateTimeFormatInfo vrácené vlastností DateTimeFormat a vlastnosti instance NumberFormatInfo vrácené vlastností NumberFormat.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. 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.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.

V opačném případě tento konstruktor vytvoří CultureInfo, který používá výchozí hodnoty pro zadanou jazykovou verzi.Otherwise, this constructor creates a CultureInfo that uses the default values for the specified culture.

Hodnota parametru useUserOverride se zobrazí jako hodnota vlastnosti UseUserOverride.The value of the useUserOverride parameter becomes the value of the UseUserOverride property.

Předpokládejme například, že Arabština (Saúdská Arábie) je aktuální jazyková verze systému Windows a uživatel změnil kalendář z kalendáře hidžra na gregoriánský.For example, suppose that Arabic (Saudi Arabia) is the current culture of Windows and the user changed the calendar from Hijri to Gregorian.

Vlastnost LCID nového CultureInfo je nastavena na identifikátor jazykové verze přidružený k zadanému názvu.The LCID property of the new CultureInfo is set to the culture identifier associated with the specified name.

Pro jazykové verze, které používají euro, .NET Framework a Windows XP nastaví výchozí měnu jako euro.For cultures that use the euro, the .NET Framework and Windows XP set the default currency as euro. Starší verze Windows to ale neudělá.However, older versions of Windows do not do this. 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.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. To use the .NET Framework default setting for the currency, the application should set the useUserOverride parameter to false.To use the .NET Framework default setting for the currency, the application should set the useUserOverride parameter to false.

Poznámky pro volající

.NET Framework 3.5.NET Framework 3.5 a starší verze vyvolají ArgumentException, pokud name není platný název jazykové verze.The .NET Framework 3.5.NET Framework 3.5 and earlier versions throw an ArgumentException if name is not a valid culture name. Starting with the .NET Framework 4.NET Framework 4, this constructor throws a CultureNotFoundException.Starting with the .NET Framework 4.NET Framework 4, this constructor throws a CultureNotFoundException. Počínaje aplikacemi, které běží v .NET Framework 4.NET Framework 4 nebo novějším ve Windows 7 nebo novějším, se metoda pokusí načíst objekt CultureInfo, jehož identifikátor je name z operačního systému. Pokud operační systém tuto jazykovou verzi nepodporuje a pokud name není název doplňkové nebo nahrazující jazykové verze, vyvolá metoda výjimku CultureNotFoundException.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.

Viz také

Platí pro