Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C#

Formater Price avec IFormattable, IFormatProvider et NumberFormatInfo

Définissez le contrat de `Price.ToString`, transmettez les paramètres numériques à `decimal` et changez le séparateur décimal dans une copie modifiable plutôt que dans l’original.

Version : C# 12 and .NET 8; later runtimes may add compatible features

Syntaxe

System.IFormattable: string ToString(string? format, IFormatProvider? formatProvider);
System.IFormatProvider: object? GetFormat(Type? formatType);
System.Globalization.NumberFormatInfo: public object Clone();
Writable copy: var copy = (NumberFormatInfo)source.Clone();
Direct call: price.ToString("F2", copy)
Composite call: string.Format(copy, "{0:F2}", price)

System.IFormattable définit la méthode ToString(format, formatProvider) à deux arguments. L’implémentation doit prendre en charge le format général G et accepter null pour sélectionner son format par défaut. La méthode ToString() sans paramètre redéfinit séparément object.ToString(). Dans l’exemple, elle appelle la même implémentation en passant null pour les deux arguments.

Price choisit les formats acceptés : null, la chaîne vide, G et g sélectionnent le format général de decimal ; F2 et f2 affichent exactement deux chiffres après le séparateur décimal, sans groupement des chiffres ni symbole monétaire. Les autres formats déclenchent FormatException. Seul le texte change, pas le montant stocké.

System.IFormatProvider fournit des paramètres, mais ne formate pas le montant. GetFormat(Type?) renvoie un objet du type demandé, ou null s’il ne peut pas le fournir. Pour formater un decimal, CultureInfo fournit ses paramètres NumberFormat, tandis que System.Globalization.NumberFormatInfo peut se renvoyer lui-même. Si le fournisseur vaut null ou ne fournit pas de paramètres numériques, decimal utilise la culture actuelle. Dans l’exemple, string.Format transmet F2 et la copie à l’implémentation de IFormattable.ToString dans Price.

NumberFormatInfo.InvariantInfo est en lecture seule : y définir NumberDecimalSeparator déclenche InvalidOperationException. Clone() renvoie une copie superficielle modifiable de type object. Convertissez-la explicitement en NumberFormatInfo, puis changez le séparateur sur la copie. Passer cette copie à un appel ne modifie ni l’original ni la culture actuelle.

Exemples

#nullable enable
using System;
using System.Globalization;

var price = new Price(1234.5m);
var original = NumberFormatInfo.InvariantInfo;
var copy = (NumberFormatInfo)original.Clone();
copy.NumberDecimalSeparator = ",";

IFormattable formattable = price;
Console.WriteLine(formattable.ToString(null, original));
Console.WriteLine(string.Format(copy, "{0:F2}", price));
Console.WriteLine(price.ToString("F2", original));

public sealed class Price(decimal amount) : IFormattable
{
    public override string ToString() => ToString(null, null);

    public string ToString(string? format, IFormatProvider? formatProvider)
        => format switch
        {
            null or "" or "G" or "g" => amount.ToString("G", formatProvider),
            "F2" or "f2" => amount.ToString("F2", formatProvider),
            _ => throw new FormatException("Unsupported Price format.")
        };
}

Résultat

1234.5
1234,50
1234.50

La première ligne montre le format par défaut sélectionné par `null`. Les deux dernières utilisent `F2` : la virgule vient de la copie et le point de l’original inchangé.

Leçons associées

  • C# · Leçon 33 · Intermédiaire · Version : 2

Sources