CKTIS / C#
Oblikovanje Price z IFormattable, IFormatProvider in NumberFormatInfo
Določi pogodbo metode `Price.ToString`, posreduj številske nastavitve tipu `decimal` in spremeni decimalno ločilo v zapisljivi kopiji namesto v izvirniku.
Različica: C# 12 and .NET 8; later runtimes may add compatible features
Sintaksa
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 določa metodo ToString(format, formatProvider) z dvema argumentoma. Implementacija mora podpirati splošno obliko G in sprejeti null za izbiro privzete oblike. Metoda ToString() brez parametrov je ločena preglasitev metode object.ToString(). V primeru pokliče isto implementacijo z vrednostjo null pri obeh argumentih.
Price določa, katere oblike sprejema: null, prazen niz, G in g izberejo splošno obliko tipa decimal; F2 in f2 prikažeta natanko dve decimalni mesti, brez združevanja števk in brez simbola valute. Druge oblike sprožijo FormatException. Oblikovanje spremeni besedilo, ne shranjenega zneska.
System.IFormatProvider zagotavlja nastavitve, ne oblikuje pa zneska. GetFormat(Type?) vrne objekt zahtevanega tipa ali null, če ga ne more zagotoviti. Pri oblikovanju vrednosti decimal CultureInfo zagotovi svoje nastavitve NumberFormat, System.Globalization.NumberFormatInfo pa lahko vrne samega sebe. Če je ponudnik null ali ne zagotovi številskih nastavitev, decimal uporabi trenutno kulturo. Klic string.Format v primeru posreduje F2 in kopijo implementaciji IFormattable.ToString v tipu Price.
NumberFormatInfo.InvariantInfo je samo za branje; nastavljanje lastnosti NumberDecimalSeparator na njem sproži InvalidOperationException. Clone() vrne zapisljivo plitvo kopijo kot object. Pretvori jo v NumberFormatInfo in spremeni ločilo v kopiji. Če kopijo posreduješ pri klicu, se ne spremenita niti izvirnik niti trenutna kultura.
Primeri
#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.")
};
}Rezultat
1234.5 1234,50 1234.50
Prva vrstica prikazuje privzeto obliko, ki jo izbere `null`. Zadnji dve uporabljata `F2`: vejica prihaja iz kopije, pika pa iz nespremenjenega izvirnika.
Povezane lekcije
- C# · Lekcija 33 · Srednja · Različica: 2