Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

CultureInfo constructeur (String)

 

Date de publication : novembre 2016

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

Espace de noms:   System.Globalization
Assembly:  mscorlib (dans mscorlib.dll)

public CultureInfo(
	string name
)

Paramètres

name
Type: System.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.

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

Pour obtenir la liste des noms de cultures prédéfinis, consultez la National Language Support (NLS) API Reference au centre de développement. En outre, en commençant avec Windows 10, name peut être n’importe quelle balise de langue BCP-47 valide.

Si name est String.Empty, le constructeur crée une instance de la culture dite indifférente ; cela équivaut à la récupération de la valeur de la InvariantCulture propriété.

L’utilisateur peut choisir de substituer 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 pour afficher la date dans un format différent ou utiliser une devise autre que la valeur par défaut pour la culture. Si l’identificateur de culture associé name correspond à l’identificateur de culture de la culture actuelle de Windows, ce constructeur crée un CultureInfo objet qui utilise ces substitutions, notamment les paramètres utilisateur pour les propriétés de la DateTimeFormatInfo instance retournée par le DateTimeFormat propriété et les propriétés de la NumberFormatInfo instance retournée par le NumberFormat propriété. Si les paramètres utilisateur sont incompatibles avec la culture associée à le CultureInfo, par exemple, si le calendrier sélectionné ne fait pas partie de la 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 actuelle de Windows, ce constructeur crée un CultureInfo objet qui utilise les valeurs par défaut pour la culture spécifiée.

Le UseUserOverride 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 modifié le calendrier Hijri par le calendrier grégorien.

Le 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, le .NET Framework et Windows XP définissent la par défaut comme devise euro. Toutefois, les versions antérieures de Windows ne le faites pas. Par conséquent, si l’utilisateur d’une version antérieure de Windows n’a pas modifié le paramètre monétaire 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 de .NET Framework pour la devise, l’application doit utiliser un CultureInfo surcharge de constructeur qui accepte un useUserOverride paramètre et la valeur false.

Remarques à l’attention des appelants :

Le .NET Framework 3.5 et les versions antérieures lèvent une ArgumentException Si name n’est pas un nom de culture valide. Compter les .NET Framework 4, ce constructeur lève une CultureNotFoundException. Commençant par les applications qui s’exécutent sous le .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 est name à partir 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 complémentaire ou de remplacement, la méthode lève une exception une CultureNotFoundException exception.

L’exemple suivant récupère la culture actuelle. Si elle n’est pas 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 rend la culture du thread actuel. Dans le cas contraire, il instancie un CultureInfo objet qui représente la culture Français (Luxembourg) et rend 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

Plateforme Windows universelle
Disponible depuis 8
.NET Framework
Disponible depuis 1.1
Bibliothèque de classes portable
Pris en charge dans : plateformes .NET portables
Silverlight
Disponible depuis 2.0
Silverlight pour Windows Phone
Disponible depuis 7.0
Windows Phone
Disponible depuis 8.1
Retour au début
Afficher: