Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C#

Formattare Price con IFormattable, IFormatProvider e NumberFormatInfo

Definisci il contratto di `Price.ToString`, passa le impostazioni numeriche a `decimal` e cambia il separatore decimale in una copia modificabile, senza toccare l’originale.

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

Sintassi

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 definisce il metodo ToString(format, formatProvider) con due argomenti. L’implementazione deve supportare il formato generale G e accettare null per scegliere il formato predefinito. ToString() senza parametri è un override separato di object.ToString(). Nell’esempio richiama la stessa implementazione passando null per entrambi gli argomenti.

Price decide quali formati accettare: null, la stringa vuota, G e g selezionano il formato generale di decimal; F2 e f2 producono esattamente due cifre decimali, senza raggruppamento delle cifre né simbolo di valuta. Gli altri formati generano FormatException. La formattazione cambia il testo, non l’importo memorizzato.

System.IFormatProvider fornisce impostazioni, non formatta l’importo. GetFormat(Type?) restituisce un oggetto del tipo richiesto oppure null se non può fornirlo. Nella formattazione di un decimal, CultureInfo fornisce le proprie impostazioni NumberFormat, mentre System.Globalization.NumberFormatInfo può restituire sé stesso. Se il provider è null o non fornisce impostazioni numeriche, decimal usa le impostazioni cultura correnti. Nell’esempio, string.Format passa F2 e la copia all’implementazione di IFormattable.ToString in Price.

NumberFormatInfo.InvariantInfo è di sola lettura: impostarvi NumberDecimalSeparator genera InvalidOperationException. Clone() restituisce una copia superficiale modificabile come object. Convertila esplicitamente in NumberFormatInfo e modifica il separatore nella copia. Passare la copia a una chiamata non modifica né l’originale né le impostazioni cultura correnti.

Esempi

#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.")
        };
}

Risultato

1234.5
1234,50
1234.50

La prima riga mostra il formato predefinito selezionato con `null`. Le ultime due usano `F2`: la virgola proviene dalla copia, il punto dall’originale rimasto invariato.

Lezioni correlate

  • C# · Lezione 33 · Intermedio · Versione: 2

Fonti