CKTIS / C#
IFormattable — formátování hodnot pomocí poskytovatele formátu
System.IFormattable definuje převod hodnoty na text pomocí formátovacího řetězce a poskytovatele informací o formátování. Umožňuje vlastním typům účastnit se složeného formátování, například string.Format, místo spoléhání pouze na bezparametrické ToString().
Verze: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntaxe
public interface IFormattable
{
string ToString(string? format, IFormatProvider? formatProvider);
}System.IFormattable obsahuje jednu metodu: IFormattable.ToString(string? format, IFormatProvider? formatProvider). Parametr format vybírá reprezentaci hodnoty, zatímco formatProvider poskytuje informace o formátování, například desetinný oddělovač. Jde o knihovní kontrakt dostupný v .NET 10, nikoli o funkci vyžadující C# ve verzi preview.
Implementace musí podporovat "G" (obecný formát) a null jako výchozí formát. Příklad považuje za "G" také prázdný řetězec, při hodnotě poskytovatele null používá CultureInfo.CurrentCulture a nepodporované formáty odmítá pomocí FormatException. Další formáty určuje typ: implementace rozhraní automaticky nezajišťuje podporu všech číselných formátů.
Přetížení se dvěma parametry nenahrazuje object.ToString(). V příkladu samostatné přepsání bezparametrického ToString() deleguje na společnou implementaci. string.Format jí předává formát položky, například {0:F2}, a poskytovatele. Poskytovatel s ICustomFormatter však může formátování převzít; metoda objektu se použije, pokud tento mechanismus hodnotu nezpracuje.
Typ Distance podporuje přesně "G" a "F2" a také výchozí hodnoty null a prázdný řetězec. Při formátování podkladové hodnoty decimal předává poskytovatele dál. Obě volání používají CultureInfo.InvariantCulture, takže očekávané řádky jsou 12.5 m a 12.50 m bez ohledu na aktuální jazykovou kulturu.
Pří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ýsledek
12.5 m 12.50 m
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.