CultureInfo Constructeurs
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
culture
est inférieur à zéro.
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.
Avec
CultureInfo("0x0401")
(nom de culture ar-sa), Calendar a GregorianCalendar la valeur (qui est le paramètre utilisateur) et a la UseUserOverride valeurtrue
.Avec
CultureInfo("0x041E")
(nom de culture th-TH), Calendar a ThaiBuddhistCalendar la valeur (qui est le calendrier par défaut pour th-TH) et a la UseUserOverride valeurtrue
.
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
name
a la valeur null.
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.
Avec
CultureInfo("ar-SA")
, Calendar a la valeur GregorianCalendar (qui est le paramètre utilisateur) et UseUserOverride a la valeurtrue
.Avec
CultureInfo("th-TH")
, Calendar a la valeur ThaiBuddhistCalendar (qui est le calendrier par défaut pour th-TH) et UseUserOverride a la valeurtrue
.
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
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
culture
est inférieur à zéro.
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.
Avec
CultureInfo("0x0401", true)
(nom de culture ar-sa), Calendar a GregorianCalendar la valeur (qui est le paramètre utilisateur) et a la UseUserOverride valeurtrue
.Avec
CultureInfo("0x0401", false)
(nom de culture ar-sa), Calendar a HijriCalendar la valeur (qui est le calendrier par défaut pour AR-sa) et a la UseUserOverride valeurfalse
.Avec
CultureInfo("0x041E", true)
(nom de culture th-TH), Calendar a ThaiBuddhistCalendar la valeur (qui est le calendrier par défaut pour th-TH) et a la UseUserOverride valeurtrue
.Avec
CultureInfo("0x041E", false)
(nom de culture th-TH), Calendar a ThaiBuddhistCalendar la valeur (qui est le calendrier par défaut pour th-TH) et a la UseUserOverride valeurfalse
.
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
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
name
a la valeur null.
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.
Avec
CultureInfo("ar-SA", true)
, Calendar a la valeur GregorianCalendar (qui est le paramètre utilisateur) et UseUserOverride a la valeurtrue
.Avec
CultureInfo("ar-SA", false)
, Calendar a la valeur HijriCalendar (qui est le calendrier par défaut pour AR-sa) et UseUserOverride a la valeurfalse
.Avec
CultureInfo("th-TH", true)
, Calendar a la valeur ThaiBuddhistCalendar (qui est le calendrier par défaut pour th-TH) et UseUserOverride a la valeurtrue
.Avec
CultureInfo("th-TH", false)
, Calendar a la valeur ThaiBuddhistCalendar (qui est le calendrier par défaut pour th-TH) et UseUserOverride a la valeurfalse
.
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.