CultureInfo Constructeurs

Définition

Espace de noms:

System.Globalization

Assembly:

System.Runtime.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 sur une valeur qui spécifie s’il faut utiliser les paramètres de culture sélectionnés par l’utilisateur à partir de Windows.

CultureInfo(Int32)

Source:

CultureInfo.cs

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 le système Windows sont répertoriés dans la colonne Balise de langue de 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 CultureInfo.CultureInfode nom de paramètres régionaux , 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 via la partie des options régionales et linguistiques du Panneau de configuration. Par exemple, l’utilisateur peut choisir d’afficher la date dans un autre format ou d’utiliser une devise autre que la valeur 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 remplacements, y compris les paramètres utilisateur pour les propriétés de l’instance DateTimeFormatInfo retournée par la DateTimeFormat propriété et les propriétés de l’instance NumberFormatInfo retournée par la NumberFormat propriété . Si les paramètres utilisateur sont incompatibles avec la culture associée à ( CultureInfo par exemple, si le calendrier sélectionné n’est pas l’un OptionalCalendarsdes ) 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 Windows actuelle, ce constructeur crée un CultureInfo qui utilise les valeurs par défaut de la culture spécifiée.

La UseUserOverride propriété est toujours définie sur true.

Par exemple, supposons que l’arabe (Arabie saoudite) soit la culture Windows actuelle et que l’utilisateur ait changé le calendrier de hijri en grégorien.

• Avec CultureInfo("0x0401") (nom de culture ar-SA), Calendar est défini sur GregorianCalendar (qui est le paramètre utilisateur) et UseUserOverride est défini sur true.

• Avec CultureInfo("0x041E") (nom de culture th-TH), Calendar est défini sur ThaiBuddhistCalendar (qui est le calendrier par défaut pour th-TH) et UseUserOverride est défini sur true.

Pour les cultures qui utilisent l’euro, .NET Framework et Windows XP définissent la devise par défaut sur euro. 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 via la partie des 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 attribue la valeur false.

Notes

Pour la 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. Vous devez plutôt construire la culture à l’aide des noms de culture standard actuels de zh-Hans ou zh-Hant, sauf si vous avez une raison d’utiliser les anciens noms.

Notes pour les appelants

.NET Framework 3.5 et versions antérieures lèvent un ArgumentException si culture n’est pas un identificateur de culture valide. À compter de .NET Framework 4, ce constructeur lève un 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 d’invariant de globalisation est activé, par exemple, certains conteneurs Docker et une culture autre que la culture invariante est spécifiée.

Voir aussi

• LCID
• UseUserOverride

CultureInfo(String)

Source:

CultureInfo.cs

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 autre chose 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 ChangeEx1
{
    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 culture 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. Les noms de culture respectent la norme définie par BCP 47. En outre, à compter de Windows 10, name peut être n’importe quelle balise de langue BCP-47 valide.

Si name a String.Emptyla valeur , le constructeur crée une instance de la culture invariante ; cela revient à 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 via la partie des options régionales et linguistiques du Panneau de configuration. Par exemple, l’utilisateur peut choisir d’afficher la date dans un autre format ou d’utiliser une devise autre que la valeur par défaut pour la culture. Si l’identificateur de culture associé à correspond à name l’identificateur de culture de la culture Windows actuelle, ce constructeur crée un CultureInfo objet qui utilise ces remplacements, y compris les paramètres utilisateur pour les propriétés de l’instance DateTimeFormatInfo retournées par la DateTimeFormat propriété et les propriétés de l’instance NumberFormatInfo retournées par la NumberFormat propriété . Si les paramètres utilisateur sont incompatibles avec la culture associée à , CultureInfopar exemple, si le calendrier sélectionné n’est pas l’un OptionalCalendarsdes , 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 de la culture spécifiée.

La UseUserOverride propriété est toujours définie sur true.

Par exemple, supposons que l’arabe (Arabie saoudite) est la culture actuelle de Windows et que l’utilisateur a changé le calendrier de hijri en grégorien :

• Avec CultureInfo("ar-SA"), Calendar est défini sur GregorianCalendar (qui est le paramètre utilisateur) et UseUserOverride est défini sur true.
• Avec CultureInfo("th-TH"), Calendar est défini sur ThaiBuddhistCalendar (qui est le calendrier par défaut pour th-TH) et UseUserOverride est défini sur true.

La LCID propriété du nouveau CultureInfo est définie sur l’identificateur de culture associé au nom spécifié.

Notes pour les appelants

.NET Framework 3.5 et versions antérieures lèvent un ArgumentException si name n’est pas un nom de culture valide. À compter de .NET Framework 4, ce constructeur lève un 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 d’invariant de globalisation est activé, par exemple, certains conteneurs Docker et une culture autre que la culture invariante est spécifiée.

Voir aussi

• LCID
• UseUserOverride
• CreateSpecificCulture(String)

CultureInfo(Int32, Boolean)

Source:

CultureInfo.cs

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

true pour 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 de 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 CultureInfo.CultureInfode nom de paramètres régionaux , 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 via la partie des options régionales et linguistiques du Panneau de configuration. Par exemple, l’utilisateur peut choisir d’afficher la date dans un autre format ou d’utiliser une devise autre que la valeur par défaut pour la culture.

Les applications ne doivent généralement pas interdire les remplacements utilisateur. L’interdiction des remplacements ne garantit pas en soi la stabilité des données. Pour plus d’informations, consultez l’entrée de blog Les données de culture ne doivent pas être considérées comme stables (à l’exception de Invariant).

Si la propriété a la UseUserOverride valeur et que l’identificateur de culture spécifié correspond à true l’identificateur de la culture Windows actuelle, ce constructeur crée un CultureInfo qui utilise ces remplacements, y compris les paramètres utilisateur pour les propriétés de l’instance DateTimeFormatInfo retournée par la DateTimeFormat propriété et les propriétés de l’instance NumberFormatInfo retournée par la NumberFormat propriété . Si les paramètres utilisateur sont incompatibles avec la culture associée à , CultureInfopar exemple, si le calendrier sélectionné n’est pas l’un OptionalCalendarsdes , 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, supposons que l’arabe (Arabie saoudite) est la culture actuelle de Windows et que l’utilisateur a changé le calendrier de hijri en grégorien.

• Avec CultureInfo("0x0401", true) (nom de culture ar-SA), Calendar est défini sur GregorianCalendar (qui est le paramètre utilisateur) et UseUserOverride est défini sur true.

• Avec CultureInfo("0x0401", false) (nom de culture ar-SA), Calendar est défini sur HijriCalendar (qui est le calendrier par défaut pour ar-SA) et UseUserOverride est défini sur false.

• Avec CultureInfo("0x041E", true) (nom de culture th-TH), Calendar est défini sur ThaiBuddhistCalendar (qui est le calendrier par défaut pour th-TH) et UseUserOverride est défini sur true.

• Avec CultureInfo("0x041E", false) (nom de culture th-TH), Calendar est défini sur ThaiBuddhistCalendar (qui est le calendrier par défaut pour th-TH) et UseUserOverride est défini sur false.

Pour les cultures qui utilisent l’euro, .NET Framework et Windows XP définissent la devise par défaut sur euro. 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 via la partie des 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 sur false.

Notes

Pour une compatibilité descendante, une culture construite à l’aide d’un culture paramètre de 0x0004 ou 0x7c04 aura une Name propriété zh-CHS ou zh-CHT, respectivement. Vous devez plutôt construire la culture en utilisant les noms de culture standard actuels de zh-Hans ou zh-Hant, sauf si vous avez une raison d’utiliser les anciens noms.

Notes pour les appelants

.NET Framework 3.5 et versions antérieures lèvent un ArgumentException si culture n’est pas un identificateur de culture valide. À compter de .NET Framework 4, ce constructeur lève un 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 d’invariant de globalisation est activé, par exemple, certains conteneurs Docker et une culture autre que la culture invariante est spécifiée.

Voir aussi

• LCID
• UseUserOverride

CultureInfo(String, Boolean)

Source:

CultureInfo.cs

Initialise une nouvelle instance de la CultureInfo classe en fonction de la culture spécifiée par le nom et sur 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(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

true pour 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 culture prédéfinis, consultez 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. En outre, à compter de Windows 10, name peut être n’importe quelle balise de langue BCP-47 valide.

Si name a String.Emptyla valeur , le constructeur crée une instance de la culture invariante ; cela revient à récupérer la valeur de la InvariantCulture propriété .

L’utilisateur peut choisir de remplacer certaines des valeurs associées à la culture Windows actuelle par le biais de la partie des options régionales et linguistiques du Panneau de configuration. Par exemple, l’utilisateur peut choisir d’afficher la date dans un autre format ou d’utiliser une devise autre que la valeur par défaut pour la culture.

Les applications ne doivent généralement pas interdire les remplacements utilisateur. L’interdiction des remplacements ne garantit pas en soi la stabilité des données. Pour plus d’informations, consultez l’entrée de blog Les données de culture ne doivent pas être considérées comme stables (à l’exception de Invariant).

Si la propriété a la UseUserOverride valeur et que l’identificateur de culture associé au nom de culture spécifié correspond à true l’identificateur de culture de la culture Windows actuelle, ce constructeur crée un CultureInfo qui utilise ces remplacements, y compris les paramètres utilisateur pour les propriétés de l’instance DateTimeFormatInfo retournée par la DateTimeFormat propriété et les propriétés de l’instance NumberFormatInfo retournées par la NumberFormat propriété . Si les paramètres utilisateur sont incompatibles avec la culture associée à , CultureInfopar exemple, si le calendrier sélectionné n’est pas l’un OptionalCalendarsdes , 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, supposons que l’arabe (Arabie saoudite) soit la culture actuelle de Windows et que l’utilisateur ait changé le calendrier de hijri en grégorien.

• Avec CultureInfo("ar-SA", true), Calendar est défini sur GregorianCalendar (qui est le paramètre utilisateur) et UseUserOverride est défini sur true.

• Avec CultureInfo("ar-SA", false), Calendar est défini sur HijriCalendar (qui est le calendrier par défaut pour ar-SA) et UseUserOverride est défini sur false.

• Avec CultureInfo("th-TH", true), Calendar est défini sur ThaiBuddhistCalendar (qui est le calendrier par défaut pour th-TH) et UseUserOverride est défini sur true.

• Avec CultureInfo("th-TH", false), Calendar est défini sur ThaiBuddhistCalendar (qui est le calendrier par défaut pour th-TH) et UseUserOverride est défini sur false.

La LCID propriété du nouveau CultureInfo est définie sur l’identificateur de culture associé au nom spécifié.

Pour les cultures qui utilisent l’euro, .NET Framework et Windows XP définissent la devise par défaut sur euro. 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 via la partie des 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 sur false.

Notes pour les appelants

.NET Framework 3.5 et versions antérieures lèvent un ArgumentException si name n’est pas un nom de culture valide. À compter de .NET Framework 4, ce constructeur lève un 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 d’invariant de globalisation est activé, par exemple, certains conteneurs Docker et une culture autre que la culture invariante est spécifiée.

Voir aussi

• LCID
• UseUserOverride
• CreateSpecificCulture(String)