CKTIS / C#
IFormattable — oblikovanje vrijednosti pomoću pružatelja formata
System.IFormattable definira pretvorbu vrijednosti u tekst pomoću niza formata i pružatelja informacija o oblikovanju. Omogućuje prilagođenim tipovima sudjelovanje u složenom oblikovanju, primjerice putem string.Format, umjesto oslanjanja samo na bezparametarski ToString().
Verzija: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaksa
public interface IFormattable
{
string ToString(string? format, IFormatProvider? formatProvider);
}System.IFormattable sadrži jednu metodu: IFormattable.ToString(string? format, IFormatProvider? formatProvider). Parametar format odabire prikaz vrijednosti, dok formatProvider pruža informacije o oblikovanju, primjerice decimalni separator. To je ugovor biblioteke dostupan u .NET 10, a ne značajka za koju je potreban C# u verziji preview.
Implementacija mora podržavati "G" (opći format) i null kao zadani format. Primjer tretira i prazan niz kao "G", upotrebljava CultureInfo.CurrentCulture kada je pružatelj null te odbacuje nepodržane formate pomoću FormatException. Dodatne formate određuje tip: implementacija sučelja ne podrazumijeva automatsku podršku za sve numeričke formate.
Preopterećenje s dva parametra ne zamjenjuje object.ToString(). U primjeru zasebna nadjačana bezparametarska metoda ToString() delegira zajedničkoj implementaciji. string.Format prosljeđuje joj format stavke kao što je {0:F2} i pružatelja. No pružatelj s ICustomFormatter može preuzeti oblikovanje; metoda objekta koristi se kada taj mehanizam ne obradi vrijednost.
Tip Distance podržava točno "G" i "F2", kao i zadane vrijednosti null i prazan niz. Pri oblikovanju temeljne vrijednosti decimal prosljeđuje pružatelja. Oba poziva koriste CultureInfo.InvariantCulture, pa su očekivani retci 12.5 m i 12.50 m, neovisno o trenutačnoj kulturi.
Primjeri
#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)
};
}
}Rezultat
12.5 m 12.50 m
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.