CKTIS / C#
ICustomFormatter.Format — prilagođeno oblikovanje vrijednosti
ICustomFormatter.Format omogućuje davatelju formata da upravlja tekstualnim prikazom vrijednosti bez promjene njezina tipa. Funkcionira s IFormatProvider i metodama kao što je string.Format; implementacija treba obraditi i uobičajene formate te null.
Verzija: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaksa
string Format(string? format, object? arg, IFormatProvider? formatProvider);ICustomFormatter.Format u prostoru naziva System povratni je poziv koji se koristi pri prilagođenom oblikovanju. Za razliku od IFormattable, koju implementira tip koji se oblikuje, omogućuje definiranje pravila izvan tog tipa. API je dostupan u .NET 10; nije novost te verzije niti značajka koja zahtijeva LangVersion=preview.
Proslijedite IFormatProvider metodi string.Format ili StringBuilder.AppendFormat. Mehanizam zatraži formatter pozivom GetFormat(typeof(ICustomFormatter)). Jedna klasa može implementirati oba sučelja i vratiti this. Zatim se Format poziva za svaku stavku formata: za {0:tag} prima "tag" kao format, a arg je argument na indeksu 0. Bez specifikatora, format je null; formatProvider označava davatelja usluge oblikovanja.
Obradite vlastite kombinacije tipa i formata, a ostale slučajeve prepustite metodi IFormattable.ToString(format, provider) ili metodi ToString() bez parametara. Ako je arg == null, vratite prazan niz. Nevaljan format proslijeđen zamjenskom oblikovanju može uzrokovati FormatException; prilagođeni formatter ne bi smio olako prikriti tu pogrešku.
Primjer prepoznaje "tag" samo za int. Za ostale vrijednosti izričito koristi CultureInfo.InvariantCulture, umjesto da se oslanja na trenutačnu kulturu ili parametar formatProvider. Zato F2 daje 12.50, a null ostavlja uglate zagrade praznima.
Primjeri
#nullable enable
using System;
using System.Globalization;
Console.WriteLine(string.Format(new LabelFormatter(),
"{0:tag} | {1:F2} | [{2}]", 42, 12.5m, (object?)null));
sealed class LabelFormatter : IFormatProvider, ICustomFormatter
{
public object? GetFormat(Type? formatType) =>
formatType == typeof(ICustomFormatter) ? this : null;
public string Format(string? format, object? arg,
IFormatProvider? formatProvider)
{
if (format == "tag" && arg is int number)
return "ID-" + number.ToString("D4", CultureInfo.InvariantCulture);
return arg switch
{
null => string.Empty,
IFormattable formattable =>
formattable.ToString(format, CultureInfo.InvariantCulture) ?? string.Empty,
_ => arg.ToString() ?? string.Empty
};
}
}
Rezultat
ID-0042 | 12.50 | []
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.