NumberFormatInfo, classe

Cette classe contient des informations, telles que la devise, des séparateurs décimaux et d'autres symboles numériques.

Pour créer un objet NumberFormatInfo pour une culture spécifique, votre application crée un objet CultureInfo pour cette culture et récupère la propriété CultureInfo.NumberFormat. Pour créer un objet NumberFormatInfo pour la culture du thread en cours, l'application utilise la propriété CurrentInfo. Pour créer un objet NumberFormatInfo pour la culture dite indifférente, l'application utilise la propriété InvariantInfo pour une version en lecture seule ou utilise le constructeur NumberFormatInfo pour une version accessible en écriture. Il n'est pas possible de créer un objet NumberFormatInfo pour une culture neutre.

L'utilisateur peut choisir de substituer certaines des valeurs associées à la culture Windows en cours par le biais des options régionales et linguistiques du Panneau de configuration. Ainsi, il peut modifier le format d'affichage des dates ou utiliser une devise autre que la devise par défaut de la culture. Si la propriété CultureInfo.UseUserOverride a la valeur true, les propriétés CultureInfo.DateTimeFormat, CultureInfo.NumberFormat et CultureInfo.TextInfo sont aussi récupérées des paramètres utilisateur. Si les paramètres utilisateur ne sont pas compatibles avec la culture associée à l'objet CultureInfo par exemple, si le calendrier sélectionné ne fait pas partie des OptionalCalendars, les résultats des méthodes et les valeurs des propriétés ne sont pas définis.

Pour les versions de .NET Framework antérieures à la version 2.0, si l'application affecte la valeur true à la propriété CultureInfo.UseUserOverride, l'objet lit chaque propriété substituable par l'utilisateur uniquement lors du premier accès à cette dernière. Étant donné que NumberFormatInfo a plusieurs propriétés substituables par l'utilisateur, cette « initialisation paresseuse » peut mener à une incohérence entre de telles propriétés lorsque l'application accède à une propriété, l'utilisateur change de culture ou substitue des propriétés de la culture actuelle de l'utilisateur via les options régionales et linguistiques du Panneau de configuration, puis l'application accède ensuite à une autre propriété. Par exemple, dans une séquence comme celle-ci, il est possible d'accéder à CurrencyGroupSeparator. Ensuite, l'utilisateur peut modifier des modèles dans le Panneau de configuration et CurrencyDecimalSeparator lorsque l'utilisateur y accède, suit les nouveaux paramètres. Une incohérence similaire se produit lorsque l'utilisateur modifie la culture de l'utilisateur dans le Panneau de configuration.

Dans le .NET Framework version 2.0 et ultérieures, NumberFormatInfo n'utilise pas cette « initialisation paresseuse ». À la place, il lit toutes les propriétés substituables par l'utilisateur lors de leur création. Il reste une petite fenêtre de vulnérabilité dans laquelle ni la création d'objet ni le processus de substitution par l'utilisateur n'est atomique et les valeurs pertinentes peuvent changer pendant la création d'objet. Toutefois, l'occurrence de cette vulnérabilité est extrêmement rare.

Un format est appliqué aux valeurs numériques à l'aide de modèles standard ou personnalisés stockés dans les propriétés d'un NumberFormatInfo. Pour modifier l'affichage d'une valeur, l'application doit rendre l'objet NumberFormatInfo accessible en écriture afin que les modèles personnalisés puissent être enregistrés dans ses propriétés.

Le tableau suivant décrit les modèles de format pour chaque spécificateur de format standard et les propriétés NumberFormatInfo associées qui peuvent être définies pour modifier les formats standard. Pour plus d'informations sur l'utilisation de ces modèles, consultez Chaînes de format numériques standard.

Un objet NumberFormatInfo ne peut être créé que pour la culture dite indifférente ou pour des cultures spécifiques et non pour des cultures neutres. Pour plus d'informations sur la culture dite indifférente, les cultures spécifiques et les cultures neutres, consultez la classe CultureInfo.

NumberFormatInfo implémente l'interface ICloneable pour activer la duplication d'objets NumberFormatInfo. Elle implémente aussi IFormatProvider pour fournir les informations de mise en forme aux applications.

L'exemple suivant montre comment récupérer un objet NumberFormatInfo pour un objet CultureInfo correspondant et utilise l'objet récupéré pour interroger les informations de mise en forme des nombres pour la culture spécifique.

using System;
using System.Globalization;
using System.Text;

public sealed class App 
{
    static void Main() 
    {
        StringBuilder sb = new StringBuilder();

        // Loop through all the specific cultures known to the CLR.
        foreach (CultureInfo ci in CultureInfo.GetCultures(CultureTypes.SpecificCultures)) 
        {
            // Only show the currency symbols for cultures that speak English.
            if (ci.TwoLetterISOLanguageName != "en") continue;

            // Display the culture name and currency symbol.
            NumberFormatInfo nfi = ci.NumberFormat;
            sb.AppendFormat("The currency symbol for '{0}' is '{1}'",
                ci.DisplayName, nfi.CurrencySymbol);
            sb.AppendLine();
        }
        Console.WriteLine(sb.ToString());
    }
}

// This code produces the following output.
//
// The currency symbol for 'English (United States)' is '$'
// The currency symbol for 'English (United Kingdom)' is '�'
// The currency symbol for 'English (Australia)' is '$'
// The currency symbol for 'English (Canada)' is '$'
// The currency symbol for 'English (New Zealand)' is '$'
// The currency symbol for 'English (Ireland)' is '?'
// The currency symbol for 'English (South Africa)' is 'R'
// The currency symbol for 'English (Jamaica)' is 'J$'
// The currency symbol for 'English (Caribbean)' is '$'
// The currency symbol for 'English (Belize)' is 'BZ$'
// The currency symbol for 'English (Trinidad and Tobago)' is 'TT$'
// The currency symbol for 'English (Zimbabwe)' is 'Z$'
// The currency symbol for 'English (Republic of the Philippines)' is 'Php'

.NET Framework

.NET Framework Client Profile

Bibliothèque de classes portable

.NET pour les applications du Windows Store

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Référence

Autres ressources