CultureInfo Constructeurs

Définition

Initialise une nouvelle instance de la classe CultureInfo.Initializes a new instance of the CultureInfo class.

Surcharges

CultureInfo(Int32)

Initialise une nouvelle instance de la classe CultureInfo en fonction de la culture spécifiée par l'identificateur de culture.Initializes a new instance of the CultureInfo class based on the culture specified by the culture identifier.

CultureInfo(String)

Initialise une nouvelle instance de la classe CultureInfo basée sur la culture spécifiée par le nom.Initializes a new instance of the CultureInfo class based on the culture specified by name.

CultureInfo(Int32, Boolean)

Initialise une nouvelle instance de la classe CultureInfo en fonction de la culture spécifiée par l'identificateur de culture et de la valeur booléenne spécifiant si les paramètres de culture sélectionnés par l'utilisateur sur le système doivent être utilisés.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)

Initialise une nouvelle instance de la classe CultureInfo en fonction de la culture spécifiée par le nom et de la valeur booléenne spécifiant s'il faut utiliser les paramètres de culture sélectionnés par l'utilisateur sur le système.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)

Initialise une nouvelle instance de la classe CultureInfo en fonction de la culture spécifiée par l'identificateur de culture.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)

Paramètres

culture
Int32

Identificateur CultureInfo prédéfini, propriété LCID d'un objet CultureInfo existant ou identificateur de culture propre à Windows.A predefined CultureInfo identifier, LCID property of an existing CultureInfo object, or Windows-only culture identifier.

Exceptions

culture est inférieur à zéro.culture is less than zero.

culture n’est pas un identificateur de culture valide.culture is not a valid culture identifier. Pour plus d’informations, consultez la section Remarques à l’attention des appelants.See the Notes to Callers section for more information.

Remarques

Les identificateurs de culture prédéfinis pour les cultures disponibles sur le système Windows sont répertoriés dans la colonne balise de langue dans la liste des noms de langue/région pris en charge par 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. Les noms de culture respectent la norme définie par BCP 47.Culture names follow the standard defined by BCP 47.

Dans la plupart des cas, le paramètre culture est mappé à l’identificateur de paramètres régionaux NLS (National Language Support) correspondant.In most cases, the culture parameter is mapped to the corresponding National Language Support (NLS) locale identifier. La valeur du paramètre culture devient la valeur de la propriété LCID du nouveau CultureInfo.The value of the culture parameter becomes the value of the LCID property of the new CultureInfo.

Nous vous recommandons d’appeler le constructeur de nom de paramètres régionaux CultureInfo.CultureInfo, car les noms de paramètres régionaux sont préférables aux LCID.We recommend that you call the locale name constructor CultureInfo.CultureInfo, because locale names are preferable to LCIDs. Pour les paramètres régionaux personnalisés, un nom de paramètres régionaux est requis.For custom locales, a locale name is required.

L’utilisateur peut choisir de remplacer certaines des valeurs associées à la culture actuelle de Windows par le biais des options régionales et linguistiques du panneau de configuration.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. Par exemple, l’utilisateur peut choisir d’afficher la date dans un format différent ou d’utiliser une devise autre que celle par défaut pour la culture.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. Si l’identificateur de culture spécifié correspond à l’identificateur de culture de la culture Windows actuelle, ce constructeur crée un CultureInfo qui utilise ces substitutions, y compris les paramètres utilisateur pour les propriétés de l’instance DateTimeFormatInfo retournée par la propriété DateTimeFormat, et les propriétés de l’instance NumberFormatInfo retournée par la propriété 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. Si les paramètres utilisateur ne sont pas compatibles avec la culture associée à l' CultureInfo (par exemple, si le calendrier sélectionné n’est pas l’un des OptionalCalendars), les résultats des méthodes et les valeurs des propriétés ne sont pas définis.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.

Si l’identificateur de culture spécifié ne correspond pas à l’identificateur de la culture Windows actuelle, ce constructeur crée un CultureInfo qui utilise les valeurs par défaut pour la culture spécifiée.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.

La propriété UseUserOverride a toujours la valeur true.The UseUserOverride property is always set to true.

Par exemple, supposez que l’arabe (Arabie saoudite) est la culture Windows actuelle et que l’utilisateur a changé le calendrier Hijri en grégorien.For example, suppose that Arabic (Saudi Arabia) is the current Windows culture and the user has changed the calendar from Hijri to Gregorian.

Pour les cultures qui utilisent l’euro, les .NET Framework et Windows XP définissent la devise par défaut en euros.For cultures that use the euro, the .NET Framework and Windows XP set the default currency as euro. Toutefois, les versions antérieures de Windows ne le font pas.However, older versions of Windows do not. Par conséquent, si l’utilisateur d’une version antérieure de Windows n’a pas modifié le paramètre de devise par le biais de la section Options régionales et linguistiques du panneau de configuration, la devise peut être incorrecte.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. Pour utiliser le paramètre par défaut .NET Framework pour la devise, l’application doit utiliser une surcharge de constructeur CultureInfo qui accepte un paramètre useUserOverride et lui affecter la valeur 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.

Notes

À des fins de compatibilité descendante, une culture construite à l’aide d’un paramètre culture de 0x0004 ou 0x7c04 aura respectivement une propriété Name de zh-CHS ou zh-CHT.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. Au lieu de cela, vous devez créer la culture en utilisant les noms de culture standard zh-Hans ou zh-Hant, à moins que vous n’ayez une raison d’utiliser les noms plus anciens.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.

Notes pour les appelants

La .NET Framework 3.5.NET Framework 3.5 et les versions antérieures lèvent une ArgumentException si culture n’est pas un identificateur de culture valide.The .NET Framework 3.5.NET Framework 3.5 and earlier versions throw an ArgumentException if culture is not a valid culture identifier. À partir de la .NET Framework 4.NET Framework 4, ce constructeur lève une CultureNotFoundException.Starting with the .NET Framework 4.NET Framework 4, this constructor throws a CultureNotFoundException. À compter des applications qui s’exécutent sous le .NET Framework 4.NET Framework 4 ou version ultérieure sur Windows 7 ou version ultérieure, la méthode tente de récupérer un objet CultureInfo dont l’identificateur est culture du système d’exploitation ; Si le système d’exploitation ne prend pas en charge cette culture, la méthode lève une exception 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.

Voir aussi

CultureInfo(String)

Initialise une nouvelle instance de la classe CultureInfo basée sur la culture spécifiée par le nom.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)

Paramètres

name
String

Nom de CultureInfo prédéfini, élément Name d'un élément CultureInfo existant ou nom de culture propre à Windows.A predefined CultureInfo name, Name of an existing CultureInfo, or Windows-only culture name. name ne respecte pas la casse.name is not case-sensitive.

Exceptions

name a la valeur null.name is null.

name n’est pas un nom de culture valide.name is not a valid culture name. Pour plus d’informations, consultez la section Remarques à l’attention des appelants.For more information, see the Notes to Callers section.

Exemples

L’exemple suivant récupère la culture actuelle.The following example retrieves the current culture. S’il s’agit d’une valeur autre que la culture français (France), il appelle le constructeur CultureInfo(String) pour instancier un objet CultureInfo qui représente la culture français (France) et en fait la culture du thread actuel.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. Sinon, il instancie un objet CultureInfo qui représente la culture français (Luxembourg) et en fait la culture actuelle.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

Remarques

Pour obtenir la liste des noms de cultures prédéfinis sur les systèmes Windows, consultez la colonne balise de langue dans la liste des noms de langue/région pris en charge par 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. Les noms de culture respectent la norme définie par BCP 47.Culture names follow the standard defined by BCP 47. En outre, à compter de Windows 10, name peut être n’importe quelle balise de langage BCP-47 valide.In addition, starting with Windows 10, name can be any valid BCP-47 language tag.

Si name est String.Empty, le constructeur crée une instance de la culture dite indifférente ; Cela équivaut à récupérer la valeur de la propriété 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.

L’utilisateur peut choisir de remplacer certaines des valeurs associées à la culture actuelle de Windows par le biais des options régionales et linguistiques du panneau de configuration.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. Par exemple, l’utilisateur peut choisir d’afficher la date dans un format différent ou d’utiliser une devise autre que celle par défaut pour la culture.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. Si l’identificateur de culture associé à name correspond à l’identificateur de culture de la culture Windows actuelle, ce constructeur crée un objet CultureInfo qui utilise ces substitutions, y compris les paramètres utilisateur pour les propriétés de l’instance DateTimeFormatInfo retournée par la propriété DateTimeFormat, et les propriétés de l’instance NumberFormatInfo retournée par la propriété 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. Si les paramètres utilisateur ne sont pas compatibles avec la culture associée à l' CultureInfo, par exemple, si le calendrier sélectionné n’est pas l’un des OptionalCalendars, les résultats des méthodes et les valeurs des propriétés ne sont pas définis.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.

Si l’identificateur de culture associé à name ne correspond pas à l’identificateur de culture de la culture Windows actuelle, ce constructeur crée un objet CultureInfo qui utilise les valeurs par défaut pour la culture spécifiée.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.

La propriété UseUserOverride a toujours la valeur true.The UseUserOverride property is always set to true.

Par exemple, supposez que l’arabe (Arabie saoudite) est la culture actuelle de Windows et que l’utilisateur a changé le calendrier Hijri en grégorien.For example, suppose that Arabic (Saudi Arabia) is the current culture of Windows and the user changed the calendar from Hijri to Gregorian.

La propriété LCID du nouvel CultureInfo a la valeur de l’identificateur de culture associé au nom spécifié.The LCID property of the new CultureInfo is set to the culture identifier associated with the specified name.

Pour les cultures qui utilisent l’euro, les .NET Framework et Windows XP définissent la devise par défaut en euros.For cultures that use the euro, the .NET Framework and Windows XP set the default currency as euro. Toutefois, les versions antérieures de Windows n’effectuent pas cette opération.However, older versions of Windows do not do this. Par conséquent, si l’utilisateur d’une version antérieure de Windows n’a pas modifié le paramètre de devise par le biais de la section Options régionales et linguistiques du panneau de configuration, la devise peut être incorrecte.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. Pour utiliser le paramètre par défaut .NET Framework pour la devise, l’application doit utiliser une surcharge de constructeur CultureInfo qui accepte un paramètre useUserOverride et lui affecter la valeur 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.

Notes pour les appelants

La .NET Framework 3.5.NET Framework 3.5 et les versions antérieures lèvent une ArgumentException si name n’est pas un nom de culture valide.The .NET Framework 3.5.NET Framework 3.5 and earlier versions throw an ArgumentException if name is not a valid culture name. À partir de la .NET Framework 4.NET Framework 4, ce constructeur lève une CultureNotFoundException.Starting with the .NET Framework 4.NET Framework 4, this constructor throws a CultureNotFoundException. À compter des applications qui s’exécutent sous le .NET Framework 4.NET Framework 4 ou version ultérieure sur Windows 7 ou version ultérieure, la méthode tente de récupérer un objet CultureInfo dont l’identificateur est name du système d’exploitation ; Si le système d’exploitation ne prend pas en charge cette culture et que name n’est pas le nom d’une culture supplémentaire ou de remplacement, la méthode lève une exception 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.

Voir aussi

CultureInfo(Int32, Boolean)

Initialise une nouvelle instance de la classe CultureInfo en fonction de la culture spécifiée par l'identificateur de culture et de la valeur booléenne spécifiant si les paramètres de culture sélectionnés par l'utilisateur sur le système doivent être utilisés.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)

Paramètres

culture
Int32

Identificateur CultureInfo prédéfini, propriété LCID d'un objet CultureInfo existant ou identificateur de culture propre à Windows.A predefined CultureInfo identifier, LCID property of an existing CultureInfo object, or Windows-only culture identifier.

useUserOverride
Boolean

Valeur booléenne indiquant s'il faut utiliser les paramètres de culture sélectionnés par l'utilisateur (true) ou les paramètres de culture par défaut (false).A Boolean that denotes whether to use the user-selected culture settings (true) or the default culture settings (false).

Exceptions

culture est inférieur à zéro.culture is less than zero.

culture n’est pas un identificateur de culture valide.culture is not a valid culture identifier. Pour plus d’informations, consultez la section Remarques à l’attention des appelants.See the Notes to Callers section for more information.

Remarques

Les identificateurs de culture prédéfinis disponibles sur les systèmes Windows sont répertoriés dans la colonne balise de langue dans la liste des noms de langue/région pris en charge par 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. Les noms de culture respectent la norme définie par BCP 47.Culture names follow the standard defined by BCP 47.

Dans la plupart des cas, le paramètre culture est mappé à l’identificateur de paramètres régionaux NLS (National Language Support) correspondant.In most cases, the culture parameter is mapped to the corresponding National Language Support (NLS) locale identifier. La valeur du paramètre culture devient la valeur de la propriété LCID du nouveau CultureInfo.The value of the culture parameter becomes the value of the LCID property of the new CultureInfo.

Nous vous recommandons d’appeler le constructeur de nom de paramètres régionaux CultureInfo.CultureInfo, car les noms de paramètres régionaux sont préférables aux LCID.We recommend that you call the locale name constructor CultureInfo.CultureInfo, because locale names are preferable to LCIDs. Pour les paramètres régionaux personnalisés, un nom de paramètres régionaux est requis.For custom locales, a locale name is required.

L’utilisateur peut choisir de remplacer certaines des valeurs associées à la culture actuelle de Windows par le biais des options régionales et linguistiques du panneau de configuration.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. Par exemple, l’utilisateur peut choisir d’afficher la date dans un format différent ou d’utiliser une devise autre que celle par défaut pour la culture.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.

En général, les applications ne doivent pas interdire les remplacements de l’utilisateur.Applications should typically not disallow user overrides. Notez que le fait de ne pas autoriser les remplacements ne garantit pas la stabilité des données ; consultez le billet de blog les données de culture ne doivent pas être considérées comme stables (sauf pour les invariants).Note that disallowing overrides does not itself guarantee data stability; see the blog entry Culture data shouldn't be considered stable (except for Invariant).

Si la propriété UseUserOverride est définie sur true et que l’identificateur de culture spécifié correspond à l’identificateur de la culture Windows actuelle, ce constructeur crée un CultureInfo qui utilise ces substitutions, y compris les paramètres utilisateur pour les propriétés de l’instance DateTimeFormatInfo retournée par la propriété DateTimeFormat, et les propriétés de l’instance NumberFormatInfo retournée par la propriété 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. Si les paramètres utilisateur ne sont pas compatibles avec la culture associée à l' CultureInfo, par exemple, si le calendrier sélectionné n’est pas l’un des OptionalCalendars, les résultats des méthodes et les valeurs des propriétés ne sont pas définis.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.

Sinon, ce constructeur crée un CultureInfo qui utilise les valeurs par défaut pour la culture spécifiée.Otherwise, this constructor creates a CultureInfo that uses the default values for the specified culture.

La valeur du paramètre useUserOverride devient la valeur de la propriété UseUserOverride.The value of the useUserOverride parameter becomes the value of the UseUserOverride property.

Par exemple, supposez que l’arabe (Arabie saoudite) est la culture actuelle de Windows et que l’utilisateur a changé le calendrier Hijri en grégorien.For example, suppose that Arabic (Saudi Arabia) is the current culture of Windows and the user has changed the calendar from Hijri to Gregorian.

Pour les cultures qui utilisent l’euro, les .NET Framework et Windows XP définissent la devise par défaut en euros.For cultures that use the euro, the .NET Framework and Windows XP set the default currency as euro. Toutefois, les versions antérieures de Windows ne le font pas.However, older versions of Windows do not. Par conséquent, si l’utilisateur d’une version antérieure de Windows n’a pas modifié le paramètre de devise par le biais de la section Options régionales et linguistiques du panneau de configuration, la devise peut être incorrecte.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. Pour utiliser le paramètre par défaut .NET Framework pour la devise, l’application doit définir le paramètre useUserOverride sur false.To use the .NET Framework default setting for the currency, the application should set the useUserOverride parameter to false.

Notes

À des fins de compatibilité descendante, une culture construite à l’aide d’un paramètre culture de 0x0004 ou 0x7c04 aura respectivement une propriété Name de zh-CHS ou zh-CHT.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. Au lieu de cela, vous devez créer la culture en utilisant les noms de culture standard zh-Hans ou zh-Hant, à moins que vous n’ayez une raison d’utiliser les noms plus anciens.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.

Notes pour les appelants

La .NET Framework 3.5.NET Framework 3.5 et les versions antérieures lèvent une ArgumentException si culture n’est pas un identificateur de culture valide.The .NET Framework 3.5.NET Framework 3.5 and earlier versions throw an ArgumentException if culture is not a valid culture identifier. À partir de la .NET Framework 4.NET Framework 4, ce constructeur lève une CultureNotFoundException.Starting with the .NET Framework 4.NET Framework 4, this constructor throws a CultureNotFoundException. À compter des applications qui s’exécutent sous le .NET Framework 4.NET Framework 4 ou version ultérieure sur Windows 7 ou version ultérieure, la méthode tente de récupérer un objet CultureInfo dont l’identificateur est culture du système d’exploitation ; Si le système d’exploitation ne prend pas en charge cette culture, la méthode lève une exception 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.

Voir aussi

CultureInfo(String, Boolean)

Initialise une nouvelle instance de la classe CultureInfo en fonction de la culture spécifiée par le nom et de la valeur booléenne spécifiant s'il faut utiliser les paramètres de culture sélectionnés par l'utilisateur sur le système.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)

Paramètres

name
String

Nom de CultureInfo prédéfini, élément Name d'un élément CultureInfo existant ou nom de culture propre à Windows.A predefined CultureInfo name, Name of an existing CultureInfo, or Windows-only culture name. name ne respecte pas la casse.name is not case-sensitive.

useUserOverride
Boolean

Valeur booléenne indiquant s'il faut utiliser les paramètres de culture sélectionnés par l'utilisateur (true) ou les paramètres de culture par défaut (false).A Boolean that denotes whether to use the user-selected culture settings (true) or the default culture settings (false).

Exceptions

name a la valeur null.name is null.

name n’est pas un nom de culture valide.name is not a valid culture name. Pour plus d’informations, consultez la section Remarques à l’attention des appelants.See the Notes to Callers section for more information.

Remarques

Pour obtenir la liste des noms de cultures prédéfinis, consultez la colonne balise de langue dans la liste des noms de langue/région pris en charge par Windows.For a list of predefined culture names, see the Language tag column in the list of language/region names supported by Windows. Les noms de culture respectent la norme définie par BCP 47.Culture names follow the standard defined by BCP 47. En outre, à compter de Windows 10, name peut être n’importe quelle balise de langage BCP-47 valide.In addition, starting with Windows 10, name can be any valid BCP-47 language tag.

Si name est String.Empty, le constructeur crée une instance de la culture dite indifférente ; Cela équivaut à récupérer la valeur de la propriété 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.

L’utilisateur peut choisir de remplacer certaines des valeurs associées à la culture Windows actuelle par le biais des options régionales et linguistiques du panneau de configuration.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. Par exemple, l’utilisateur peut choisir d’afficher la date dans un format différent ou d’utiliser une devise autre que celle par défaut pour la culture.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.

En général, les applications ne doivent pas interdire les remplacements de l’utilisateur.Applications should typically not disallow user overrides. Notez que le fait de ne pas autoriser les remplacements ne garantit pas la stabilité des données ; consultez le billet de blog les données de culture ne doivent pas être considérées comme stables (sauf pour les invariants).Note that disallowing overrides does not itself guarantee data stability; see the blog entry Culture data shouldn't be considered stable (except for Invariant).

Si la propriété UseUserOverride est définie sur true et que l’identificateur de culture associé au nom de culture spécifié correspond à l’identificateur de culture de la culture Windows en cours, ce constructeur crée un CultureInfo qui utilise ces substitutions, y compris les paramètres utilisateur pour les propriétés de l’instance DateTimeFormatInfo retournée par la propriété DateTimeFormat, et les propriétés de l’instance NumberFormatInfo retournée par la propriété 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. Si les paramètres utilisateur ne sont pas compatibles avec la culture associée à l' CultureInfo, par exemple, si le calendrier sélectionné n’est pas l’un des OptionalCalendars, les résultats des méthodes et les valeurs des propriétés ne sont pas définis.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.

Sinon, ce constructeur crée un CultureInfo qui utilise les valeurs par défaut pour la culture spécifiée.Otherwise, this constructor creates a CultureInfo that uses the default values for the specified culture.

La valeur du paramètre useUserOverride devient la valeur de la propriété UseUserOverride.The value of the useUserOverride parameter becomes the value of the UseUserOverride property.

Par exemple, supposez que l’arabe (Arabie saoudite) est la culture actuelle de Windows et que l’utilisateur a changé le calendrier Hijri en grégorien.For example, suppose that Arabic (Saudi Arabia) is the current culture of Windows and the user changed the calendar from Hijri to Gregorian.

La propriété LCID du nouvel CultureInfo a la valeur de l’identificateur de culture associé au nom spécifié.The LCID property of the new CultureInfo is set to the culture identifier associated with the specified name.

Pour les cultures qui utilisent l’euro, les .NET Framework et Windows XP définissent la devise par défaut en euros.For cultures that use the euro, the .NET Framework and Windows XP set the default currency as euro. Toutefois, les versions antérieures de Windows n’effectuent pas cette opération.However, older versions of Windows do not do this. Par conséquent, si l’utilisateur d’une version antérieure de Windows n’a pas modifié le paramètre de devise par le biais de la section Options régionales et linguistiques du panneau de configuration, la devise peut être incorrecte.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. Pour utiliser le paramètre par défaut .NET Framework pour la devise, l’application doit définir le paramètre useUserOverride sur false.To use the .NET Framework default setting for the currency, the application should set the useUserOverride parameter to false.

Notes pour les appelants

La .NET Framework 3.5.NET Framework 3.5 et les versions antérieures lèvent une ArgumentException si name n’est pas un nom de culture valide.The .NET Framework 3.5.NET Framework 3.5 and earlier versions throw an ArgumentException if name is not a valid culture name. À partir de la .NET Framework 4.NET Framework 4, ce constructeur lève une CultureNotFoundException.Starting with the .NET Framework 4.NET Framework 4, this constructor throws a CultureNotFoundException. À compter des applications qui s’exécutent sous le .NET Framework 4.NET Framework 4 ou version ultérieure sur Windows 7 ou version ultérieure, la méthode tente de récupérer un objet CultureInfo dont l’identificateur est name du système d’exploitation ; Si le système d’exploitation ne prend pas en charge cette culture et que name n’est pas le nom d’une culture supplémentaire ou de remplacement, la méthode lève une exception 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.

Voir aussi

S’applique à