WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C#

Price formatieren mit IFormattable, IFormatProvider und NumberFormatInfo

Lege den Vertrag von `Price.ToString` fest, reiche die Zahlenformateinstellungen an `decimal` weiter und ändere das Dezimaltrennzeichen nur in einer beschreibbaren Kopie.

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

Syntax

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 definiert die Methode ToString(format, formatProvider) mit zwei Argumenten. Die Implementierung muss das allgemeine Format G unterstützen und bei null ihr Standardformat wählen. Das parameterlose ToString() ist eine separate Überschreibung von object.ToString(). Im Beispiel ruft sie dieselbe Implementierung mit null für beide Argumente auf.

Price legt die erlaubten Formate fest: null, die leere Zeichenfolge, G und g wählen das allgemeine decimal-Format. F2 und f2 ergeben genau zwei Nachkommastellen, ohne Zifferngruppierung und Währungssymbol. Andere Formate lösen eine FormatException aus. Die Formatierung ändert den Text, nicht den gespeicherten Betrag.

System.IFormatProvider liefert Einstellungen, formatiert aber nicht den Betrag. GetFormat(Type?) gibt ein Objekt des angeforderten Typs oder null zurück, wenn keines bereitgestellt werden kann. Bei der Formatierung eines decimal liefert CultureInfo seine NumberFormat-Einstellungen, während System.Globalization.NumberFormatInfo sich selbst zurückgeben kann. Bei einem Anbieter, der null ist oder keine Zahleneinstellungen liefert, verwendet decimal die aktuelle Kultur. Der Aufruf von string.Format im Beispiel übergibt F2 und die Kopie an die Implementierung von IFormattable.ToString in Price.

NumberFormatInfo.InvariantInfo ist schreibgeschützt. Wer dort NumberDecimalSeparator setzt, erhält eine InvalidOperationException. Clone() liefert eine beschreibbare flache Kopie als object. Wandle sie in NumberFormatInfo um und ändere das Trennzeichen in der Kopie. Übergibst du die Kopie an einen Aufruf, bleiben das Original und die aktuelle Kultur unverändert.

Beispiele

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

Ergebnis

1234.5
1234,50
1234.50

Die erste Zeile zeigt das Standardformat bei `null`. Die letzten beiden verwenden `F2`: Das Komma stammt aus der Kopie, der Punkt aus dem unveränderten Original.

Zugehörige Lektionen

  • C# · Lektion 33 · Mittlere Stufe · Version: 2

Quellen