CultureInfo Constructeurs

  • Référence

Définition

Espace de noms:
System.Globalization
Assembly:
System.Runtime.dll
Assembly:
netstandard.dll
Assembly:
mscorlib.dll
Assembly:
System.Globalization.dll

Initialise une nouvelle instance de la classe CultureInfo.

Surcharges

CultureInfo(Int32)

Initialise une nouvelle instance de la classe CultureInfo en fonction de la culture spécifiée par l'identificateur de culture.
CultureInfo(String)

Initialise une nouvelle instance de la classe CultureInfo basée sur la culture spécifiée par le nom.
CultureInfo(Int32, Boolean)

Initialise une nouvelle instance de la CultureInfo classe en fonction de la culture spécifiée par l’identificateur de culture et d’une valeur qui spécifie s’il faut utiliser les paramètres de culture sélectionnés par l’utilisateur à partir de Windows.
CultureInfo(String, Boolean)

Initialise une nouvelle instance de la CultureInfo classe en fonction de la culture spécifiée par le nom et d’une valeur qui spécifie s’il faut utiliser les paramètres de culture sélectionnés par l’utilisateur dans Windows.

CultureInfo(Int32)

Initialise une nouvelle instance de la classe CultureInfo en fonction de la culture spécifiée par l'identificateur de culture.

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.

Exceptions

ArgumentOutOfRangeException

culture est inférieur à zéro.

CultureNotFoundException

culture n’est pas un identificateur de culture valide. Pour plus d’informations, consultez la section Remarques à l’attention des appelants.

Remarques

les identificateurs de culture prédéfinis pour les cultures disponibles sur Windows système sont répertoriés dans la colonne balise de langue dans la liste des noms de langue/région pris en charge par Windows. Les noms de culture respectent la norme définie par BCP 47.

Dans la plupart des cas, le culture paramètre est mappé à l’identificateur de paramètres régionaux NLS (National Language Support) correspondant. La valeur du culture paramètre devient la valeur de la LCID propriété du nouveau 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. Pour les paramètres régionaux personnalisés, un nom de paramètres régionaux est requis.

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. 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. 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' DateTimeFormatInfo instance retournée par la DateTimeFormat propriété, et les propriétés de l' NumberFormatInfo instance retournée par la NumberFormat propriété. Si les paramètres utilisateur ne sont pas compatibles avec la culture associée à CultureInfo (par exemple, si le calendrier sélectionné ne fait pas partie du OptionalCalendars ), les résultats des méthodes et les valeurs des propriétés ne sont pas définis.

si l’identificateur de culture spécifié ne correspond pas à l’identificateur de la culture de Windows actuelle, ce constructeur crée un CultureInfo qui utilise les valeurs par défaut pour la culture spécifiée.

La UseUserOverride propriété a toujours la valeur true .

par exemple, supposons que l’arabe (arabie saoudite) est la culture actuelle de la Windows et que l’utilisateur a changé le calendrier Hijri en grégorien.

pour les cultures qui utilisent l’euro, .NET Framework et Windows XP définissent la devise par défaut en euros. toutefois, les versions antérieures de Windows ne le font pas. 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. pour utiliser le paramètre par défaut .NET Framework pour la devise, l’application doit utiliser une CultureInfo surcharge de constructeur qui accepte un useUserOverride paramètre et lui affecter la valeur false .

Notes

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

Notes pour les appelants

.NET Framework 3,5 et les versions antérieures lèvent une exception ArgumentException si culture n’est pas un identificateur de culture valide. à partir de .NET Framework 4, ce constructeur lève une exception CultureNotFoundException . à compter des applications qui s’exécutent sous .NET Framework 4 ou version ultérieure sur Windows 7 ou version ultérieure, la méthode tente de récupérer un CultureInfo objet dont l’identificateur provient 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 CultureNotFoundException exception.

Sur .NET 6 et versions ultérieures, une CultureNotFoundException exception est levée si l’application s’exécute dans un environnement où le mode de globalisation-indifférent est activé, par exemple, certains conteneurs d’ancrage et une culture autre que la culture dite indifférente est spécifiée.

Voir aussi

S’applique à

CultureInfo(String)

Initialise une nouvelle instance de la classe CultureInfo basée sur la culture spécifiée par le nom.

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. name ne respecte pas la casse.

Exceptions

ArgumentNullException

name a la valeur null.

CultureNotFoundException

name n’est pas un nom de culture valide. Pour plus d’informations, consultez la section Remarques à l’attention des appelants.

Exemples

L’exemple suivant récupère la culture actuelle. S’il s’agit d’une valeur autre que la culture français (France), il appelle le CultureInfo(String) constructeur pour instancier un CultureInfo objet qui représente la culture français (France) et en fait la culture actuelle. Sinon, il instancie un CultureInfo objet qui représente la culture français (Luxembourg) et en fait la culture actuelle.

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 tag language dans la liste des noms de langue/région pris en charge par Windows. Les noms de culture respectent la norme définie par BCP 47. en outre, à partir de Windows 10, name peut être n’importe quelle balise de langage BCP-47 valide.

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 InvariantCulture propriété.

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. 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. si l’identificateur de culture associé à name correspond à l’identificateur de culture de la culture Windows actuelle, ce constructeur crée un CultureInfo objet qui utilise ces substitutions, y compris les paramètres utilisateur pour les propriétés de l' DateTimeFormatInfo instance retournée par la DateTimeFormat propriété, et les propriétés de l' NumberFormatInfo instance retournée par la NumberFormat propriété. Si les paramètres utilisateur ne sont pas compatibles avec la culture associée à 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.

si l’identificateur de culture associé à name ne correspond pas à l’identificateur de culture de la culture Windows actuelle, ce constructeur crée un CultureInfo objet qui utilise les valeurs par défaut pour la culture spécifiée.

La UseUserOverride propriété a toujours la valeur 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.

La LCID propriété du nouveau CultureInfo a la valeur de l’identificateur de culture associé au nom spécifié.

pour les cultures qui utilisent l’euro, les .NET Framework et Windows XP définissent la devise par défaut en euros. toutefois, les versions antérieures de Windows n’effectuent pas cette opération. 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. pour utiliser le paramètre par défaut .NET Framework pour la devise, l’application doit utiliser une CultureInfo surcharge de constructeur qui accepte un useUserOverride paramètre et lui affecter la valeur false .

Notes pour les appelants

.NET Framework 3,5 et les versions antérieures lèvent une exception ArgumentException si name n’est pas un nom de culture valide. à partir de .NET Framework 4, ce constructeur lève une exception CultureNotFoundException . à compter des applications qui s’exécutent sous .NET Framework 4 ou version ultérieure sur Windows 7 ou version ultérieure, la méthode tente de récupérer un CultureInfo objet dont l’identificateur provient name du système d’exploitation ; si le système d’exploitation ne prend pas en charge cette culture et si name n’est pas le nom d’une culture supplémentaire ou de remplacement, la méthode lève une CultureNotFoundException exception.

Sur .NET 6 et versions ultérieures, une CultureNotFoundException exception est levée si l’application s’exécute dans un environnement où le mode de globalisation-indifférent est activé, par exemple, certains conteneurs d’ancrage et une culture autre que la culture dite indifférente est spécifiée.

Voir aussi

S’applique à

CultureInfo(Int32, Boolean)

Initialise une nouvelle instance de la CultureInfo classe en fonction de la culture spécifiée par l’identificateur de culture et d’une valeur qui spécifie s’il faut utiliser les paramètres de culture sélectionnés par l’utilisateur à partir de Windows.

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.

useUserOverride
Boolean

truepour utiliser les paramètres de culture sélectionnés par l’utilisateur (Windows uniquement); false pour utiliser les paramètres de culture par défaut.

Exceptions

ArgumentOutOfRangeException

culture est inférieur à zéro.

CultureNotFoundException

culture n’est pas un identificateur de culture valide. Pour plus d’informations, consultez la section Remarques à l’attention des appelants.

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. Les noms de culture respectent la norme définie par BCP 47.

Dans la plupart des cas, le culture paramètre est mappé à l’identificateur de paramètres régionaux NLS (National Language Support) correspondant. La valeur du culture paramètre devient la valeur de la LCID propriété du nouveau 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. Pour les paramètres régionaux personnalisés, un nom de paramètres régionaux est requis.

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. 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.

En général, les applications ne doivent pas interdire les remplacements de l’utilisateur. Interdire les remplacements ne garantit pas la stabilité des données. Pour plus d’informations, consultez le billet de blog les données de culture ne doivent pas être considérées comme stables (sauf pour les invariants).

si la UseUserOverride propriété a la valeur 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' DateTimeFormatInfo instance retournée par la DateTimeFormat propriété, et les propriétés de l' NumberFormatInfo instance retournée par la NumberFormat propriété. Si les paramètres utilisateur ne sont pas compatibles avec la culture associée à 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.

Sinon, ce constructeur crée un CultureInfo qui utilise les valeurs par défaut pour la culture spécifiée.

La valeur du useUserOverride paramètre devient la valeur de la UseUserOverride propriété.

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.

pour les cultures qui utilisent l’euro, les .NET Framework et Windows XP définissent la devise par défaut en euros. toutefois, les versions antérieures de Windows ne le font pas. 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. pour utiliser le paramètre par défaut .NET Framework pour la devise, l’application doit définir le useUserOverride paramètre avec la valeur false .

Notes

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

Notes pour les appelants

.NET Framework 3,5 et les versions antérieures lèvent une exception ArgumentException si culture n’est pas un identificateur de culture valide. à partir de .NET Framework 4, ce constructeur lève une exception CultureNotFoundException . à compter des applications qui s’exécutent sous .NET Framework 4 ou version ultérieure sur Windows 7 ou version ultérieure, la méthode tente de récupérer un CultureInfo objet dont l’identificateur provient 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 CultureNotFoundException exception.

Sur .NET 6 et versions ultérieures, une CultureNotFoundException exception est levée si l’application s’exécute dans un environnement où le mode de globalisation-indifférent est activé, par exemple, certains conteneurs d’ancrage et une culture autre que la culture dite indifférente est spécifiée.

Voir aussi

S’applique à

CultureInfo(String, Boolean)

Initialise une nouvelle instance de la CultureInfo classe en fonction de la culture spécifiée par le nom et d’une valeur qui spécifie s’il faut utiliser les paramètres de culture sélectionnés par l’utilisateur dans Windows.

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. name ne respecte pas la casse.

useUserOverride
Boolean

truepour utiliser les paramètres de culture sélectionnés par l’utilisateur (Windows uniquement); false pour utiliser les paramètres de culture par défaut.

Exceptions

ArgumentNullException

name a la valeur null.

CultureNotFoundException

name n’est pas un nom de culture valide. Pour plus d’informations, consultez la section Remarques à l’attention des appelants.

Remarques

Pour obtenir la liste des noms de cultures prédéfinis, consultez la colonne tag Language dans la liste des noms de langue/région pris en charge par Windows. Les noms de culture respectent la norme définie par BCP 47. en outre, à partir de Windows 10, name peut être n’importe quelle balise de langage BCP-47 valide.

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 InvariantCulture propriété.

l’utilisateur peut choisir de remplacer certaines des valeurs associées à la culture actuelle de l’Windows par le biais des options régionales et linguistiques du panneau de configuration. 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.

En général, les applications ne doivent pas interdire les remplacements de l’utilisateur. Interdire les remplacements ne garantit pas la stabilité des données. Pour plus d’informations, consultez le billet de blog les données de culture ne doivent pas être considérées comme stables (sauf pour les invariants).

si la UseUserOverride propriété a la valeur true et que l’identificateur de culture associé au nom 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' DateTimeFormatInfo instance retournée par la DateTimeFormat propriété, et les propriétés de l' NumberFormatInfo instance retournée par la NumberFormat propriété. Si les paramètres utilisateur ne sont pas compatibles avec la culture associée à 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.

Sinon, ce constructeur crée un CultureInfo qui utilise les valeurs par défaut pour la culture spécifiée.

La valeur du useUserOverride paramètre devient la valeur de la UseUserOverride propriété.

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.

La LCID propriété du nouveau CultureInfo a la valeur de l’identificateur de culture associé au nom spécifié.

pour les cultures qui utilisent l’euro, les .NET Framework et Windows XP définissent la devise par défaut en euros. toutefois, les versions antérieures de Windows n’effectuent pas cette opération. 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. pour utiliser le paramètre par défaut .NET Framework pour la devise, l’application doit définir le useUserOverride paramètre avec la valeur false .

Notes pour les appelants

.NET Framework 3,5 et les versions antérieures lèvent une exception ArgumentException si name n’est pas un nom de culture valide. à partir de .NET Framework 4, ce constructeur lève une exception CultureNotFoundException . à compter des applications qui s’exécutent sous .NET Framework 4 ou version ultérieure sur Windows 7 ou version ultérieure, la méthode tente de récupérer un CultureInfo objet dont l’identificateur provient name du système d’exploitation ; si le système d’exploitation ne prend pas en charge cette culture et si name n’est pas le nom d’une culture supplémentaire ou de remplacement, la méthode lève une CultureNotFoundException exception.

Sur .NET 6 et versions ultérieures, une CultureNotFoundException exception est levée si l’application s’exécute dans un environnement où le mode de globalisation-indifférent est activé, par exemple, certains conteneurs d’ancrage et une culture autre que la culture dite indifférente est spécifiée.

Voir aussi

S’applique à