CKTIS / C#
Formátování Price pomocí IFormattable, IFormatProvider a NumberFormatInfo
Definuj kontrakt metody `Price.ToString`, předej nastavení čísel typu `decimal` a uprav desetinný oddělovač v zapisovatelné kopii, nikoli v původním objektu.
Verze: 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 definuje metodu ToString(format, formatProvider) se dvěma argumenty. Implementace musí podporovat obecný formát G a přijímat null pro výběr výchozího formátu. Bezparametrová metoda ToString() je samostatným přepsáním metody object.ToString(). V příkladu volá tutéž implementaci s hodnotou null v obou argumentech.
Price určuje, které formáty přijímá: null, prázdný řetězec, G a g vybírají obecný formát typu decimal; F2 a f2 vypíšou přesně dvě desetinná místa bez seskupování číslic a bez symbolu měny. Jiné formáty vyvolají FormatException. Formátování mění text, ne uloženou částku.
System.IFormatProvider poskytuje nastavení, sám ale částku neformátuje. GetFormat(Type?) vrací objekt požadovaného typu, nebo null, pokud jej nedokáže poskytnout. Při formátování hodnoty decimal poskytuje CultureInfo své nastavení NumberFormat, zatímco System.Globalization.NumberFormatInfo může vrátit sám sebe. Pokud je poskytovatel null nebo neposkytne nastavení čísel, decimal použije aktuální jazykové a regionální nastavení. Volání string.Format v příkladu předá F2 a kopii implementaci IFormattable.ToString v typu Price.
NumberFormatInfo.InvariantInfo je jen pro čtení; pokus nastavit na něm NumberDecimalSeparator vyvolá InvalidOperationException. Clone() vrací zapisovatelnou mělkou kopii jako object. Přetypuj ji na NumberFormatInfo a změň oddělovač v kopii. Předání kopie při volání nezmění původní objekt ani aktuální jazykové a regionální nastavení.
Příklady
#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.")
};
}Výsledek
1234.5 1234,50 1234.50
První řádek ukazuje výchozí formát vybraný hodnotou `null`. Poslední dva používají `F2`: čárka pochází z kopie a tečka z nezměněného původního objektu.
Související lekce
- C# · Lekce 33 · Středně pokročilá · Verze: 2