CKTIS / C#
IFormattable — formátovanie hodnôt pomocou poskytovateľa formátu
System.IFormattable definuje prevod hodnoty na text pomocou formátovacieho reťazca a poskytovateľa informácií o formátovaní. Umožňuje vlastným typom zúčastňovať sa zloženého formátovania, napríklad string.Format, namiesto spoliehania sa iba na bezparametrické ToString().
Verzia: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntax
public interface IFormattable
{
string ToString(string? format, IFormatProvider? formatProvider);
}System.IFormattable obsahuje jednu metódu: IFormattable.ToString(string? format, IFormatProvider? formatProvider). Parameter format vyberá reprezentáciu hodnoty, zatiaľ čo formatProvider poskytuje informácie o formátovaní, napríklad desatinný oddeľovač. Ide o knižničný kontrakt dostupný v .NET 10, nie o funkciu vyžadujúcu C# vo verzii preview.
Implementácia musí podporovať "G" (všeobecný formát) a null ako predvolený formát. Príklad považuje za "G" aj prázdny reťazec, pri hodnote poskytovateľa null používa CultureInfo.CurrentCulture a nepodporované formáty odmieta pomocou FormatException. Ďalšie formáty určuje typ: implementácia rozhrania automaticky nezabezpečuje podporu všetkých číselných formátov.
Preťaženie s dvoma parametrami nenahrádza object.ToString(). V príklade samostatné prepísanie bezparametrického ToString() deleguje na spoločnú implementáciu. string.Format jej odovzdáva formát položky, napríklad {0:F2}, a poskytovateľa. Poskytovateľ s ICustomFormatter však môže formátovanie prevziať; metóda objektu sa použije, keď tento mechanizmus hodnotu nespracuje.
Typ Distance podporuje presne "G" a "F2" a tiež predvolené hodnoty null a prázdny reťazec. Pri formátovaní podkladovej hodnoty decimal odovzdáva poskytovateľa ďalej. Obe volania používajú CultureInfo.InvariantCulture, takže očakávané riadky sú 12.5 m a 12.50 m bez ohľadu na aktuálnu kultúru.
Príklady
#nullable enable
using System;
using System.Globalization;
var distance = new Distance(12.5m);
IFormattable value = distance;
Console.WriteLine(value.ToString(null, CultureInfo.InvariantCulture));
Console.WriteLine(string.Format(CultureInfo.InvariantCulture, "{0:F2}", distance));
public sealed class Distance : IFormattable
{
private readonly decimal meters;
public Distance(decimal meters) => this.meters = meters;
public override string ToString() =>
ToString("G", CultureInfo.CurrentCulture);
public string ToString(string? format, IFormatProvider? formatProvider)
{
formatProvider ??= CultureInfo.CurrentCulture;
return format switch
{
null or "" or "G" => meters.ToString("G", formatProvider) + " m",
"F2" => meters.ToString("F2", formatProvider) + " m",
_ => throw new FormatException("Unsupported format: " + format)
};
}
}Výsledok
12.5 m 12.50 m
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.