CultureInfo Constructeurs

  • Référence

Définition

Espace de noms:
System.Globalization
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.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 classe en fonction de la CultureInfo 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 nom 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(Int32)

Source:
CultureInfo.cs
Source:
CultureInfo.cs
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 de 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 du DateTimeFormatInfo instance retournés par la DateTimeFormat propriété, et les propriétés du NumberFormatInfo instance retournées par la NumberFormat propriété. Si les paramètres utilisateur ne sont pas compatibles avec la culture associée CultureInfo au (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) est la culture Windows actuelle et que l’utilisateur a changé le calendrier de Hijri en grégorien.

Pour les cultures qui utilisent l’euro, .NET Framework et Windows XP définissent la devise par défaut comme 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 de 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 le définir sur 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 préférer 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 les versions antérieures lèvent un si culture n’est ArgumentException pas un identificateur de culture valide. À compter de .NET Framework 4, ce constructeur lève un CultureNotFoundException. À partir 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, un CultureNotFoundException est levée si l’application s’exécute dans un environnement où le mode invariant de globalisation est activé, par exemple certains conteneurs Docker, et une culture autre que la culture invariante est spécifiée.

Voir aussi

S’applique à

CultureInfo(String)

Source:
CultureInfo.cs
Source:
CultureInfo.cs
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 de quelque chose d’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 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, à partir de Windows 10, name peut être n’importe quelle balise de langue BCP-47 valide.

Si name a la valeur String.Empty, le constructeur crée une instance de la culture invariante ; 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 via la partie des options régionales et linguistiques de 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 du DateTimeFormatInfo instance retournés par la DateTimeFormat propriété, et les propriétés du NumberFormatInfo instance retournées par la NumberFormat propriété. Si les paramètres utilisateur ne sont pas compatibles 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é à ne correspond pas à name 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é 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 :

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. À partir 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, un CultureNotFoundException est levée si l’application s’exécute dans un environnement où le mode invariant de globalisation est activé, par exemple certains conteneurs Docker, et une culture autre que la culture invariante est spécifiée.

Voir aussi

S’applique à

CultureInfo(Int32, Boolean)

Source:
CultureInfo.cs
Source:
CultureInfo.cs
Source:
CultureInfo.cs

Initialise une nouvelle instance de la classe en fonction de la CultureInfo 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 de 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 UseUserOverride propriété est définie sur 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 du DateTimeFormatInfo instance retournés par la DateTimeFormat propriété, et les propriétés du NumberFormatInfo instance retournées par la NumberFormat propriété. Si les paramètres utilisateur ne sont pas compatibles 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.

Pour les cultures qui utilisent l’euro, .NET Framework et Windows XP définissent la devise par défaut comme 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 de 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 la compatibilité descendante, une culture construite à l’aide d’un culture paramètre de 0x0004 ou de 0x7c04 aura une Name propriété zh-CHS ou zh-CHT, respectivement. Vous devez plutôt préférer 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 les versions antérieures lèvent un si culture n’est ArgumentException pas un identificateur de culture valide. À compter de .NET Framework 4, ce constructeur lève un CultureNotFoundException. À partir 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, un CultureNotFoundException est levée si l’application s’exécute dans un environnement où le mode invariant de globalisation est activé, par exemple certains conteneurs Docker, et une culture autre que la culture invariante est spécifiée.

Voir aussi

S’applique à

CultureInfo(String, Boolean)

Source:
CultureInfo.cs
Source:
CultureInfo.cs
Source:
CultureInfo.cs

Initialise une nouvelle instance de la CultureInfo classe en fonction de la culture spécifiée par nom 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(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, à partir de Windows 10, name peut être n’importe quelle balise de langue BCP-47 valide.

Si name a la valeur String.Empty, le constructeur crée une instance de la culture invariante ; 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 Windows actuelle par le biais de la partie des options régionales et linguistiques de 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 UseUserOverride propriété est définie sur 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 du DateTimeFormatInfo instance retournés par la DateTimeFormat propriété, et les propriétés du NumberFormatInfo instance retournées par la NumberFormat propriété. Si les paramètres utilisateur ne sont pas compatibles 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.

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 comme 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 de 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. À partir 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, un CultureNotFoundException est levée si l’application s’exécute dans un environnement où le mode invariant de globalisation est activé, par exemple certains conteneurs Docker, et une culture autre que la culture invariante est spécifiée.

Voir aussi

S’applique à