Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C#

Formatowanie Price: IFormattable, IFormatProvider i NumberFormatInfo

Zdefiniuj kontrakt `Price.ToString`, przekaż ustawienia liczbowe do `decimal` i zmień separator dziesiętny w zapisywalnej kopii zamiast w obiekcie źródłowym.

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

Składnia

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 definiuje dwuargumentową metodę ToString(format, formatProvider). Implementacja musi obsługiwać ogólny format G i przyjmować null jako wybór formatu domyślnego. Bezargumentowe ToString() to osobna metoda przesłaniająca metodę object.ToString(). W przykładzie przekazuje ona oba argumenty jako null do tej samej implementacji.

To Price decyduje, które formaty przyjmuje: null, pusty ciąg, G i g wybierają ogólny format decimal, a F2 i f2 dają dokładnie dwie cyfry po separatorze, bez grupowania i symbolu waluty. Inne formaty powodują FormatException. Zmienia się tekst, nie zapisana kwota.

System.IFormatProvider udostępnia ustawienia, a nie formatuje kwoty. GetFormat(Type?) zwraca obiekt żądanego typu lub null, jeśli go nie udostępnia. Przy formatowaniu decimal obiekt CultureInfo udostępnia swoje ustawienia NumberFormat, a System.Globalization.NumberFormatInfo może zwrócić sam siebie. Jeśli dostawca jest null lub nie udostępnia ustawień liczbowych, decimal używa bieżącej kultury. Wywołanie string.Format z przykładu przekazuje F2 i kopię do metody IFormattable.ToString obiektu Price.

NumberFormatInfo.InvariantInfo jest tylko do odczytu; próba ustawienia na nim NumberDecimalSeparator powoduje InvalidOperationException. Clone() zwraca zapisywalną płytką kopię jako object. Rzutuj ją na NumberFormatInfo i zmień separator na kopii. Przekazanie kopii do wywołania nie zmienia źródła ani bieżącej kultury.

Przykłady

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

Wynik

1234.5
1234,50
1234.50

Pierwszy wiersz pokazuje format domyślny przy `null`. Dwa ostatnie używają `F2`: przecinek pochodzi z kopii, a kropka z niezmienionego źródła.

Powiązane lekcje

  • C# · Lekcja 33 · Średniozaawansowany · Wersja: 2

Źródła