CKTIS / C#
ICustomFormatter.Format — персонализирано форматиране на стойности
ICustomFormatter.Format позволява на доставчик на форматиране да управлява текстовото представяне на стойност, без да променя типа ѝ. Работи с IFormatProvider и методи като string.Format; реализацията трябва да обработва и обичайните формати и null.
Версия: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Синтаксис
string Format(string? format, object? arg, IFormatProvider? formatProvider);ICustomFormatter.Format в пространството от имена System е метод, който механизмът за персонализирано форматиране извиква при нужда (callback). За разлика от IFormattable, която се реализира от форматирания тип, тя позволява да задавате правила извън този тип. API е наличен в .NET 10; не е новост в тази версия и не изисква LangVersion=preview.
Подайте IFormatProvider на string.Format или StringBuilder.AppendFormat. Механизмът изисква форматиращ обект чрез GetFormat(typeof(ICustomFormatter)). Един клас може да реализира и двата интерфейса и да връща this. След това Format се извиква за всеки елемент за форматиране: при {0:tag} получава "tag" като format, а arg е аргументът с индекс 0. Без спецификатор format е null; formatProvider обозначава доставчика на услугата за форматиране.
Обработвайте персонализираните си комбинации от тип и формат, а останалите случаи делегирайте на IFormattable.ToString(format, provider) или на ToString() без параметри. При arg == null върнете празен низ. Невалиден формат, предаден на резервното форматиране, може да причини FormatException; персонализираният форматиращ обект не бива безразборно да прикрива тази грешка.
Примерът разпознава "tag" само за int. За останалите стойности изрично използва CultureInfo.InvariantCulture, вместо да разчита на текущата култура или параметъра formatProvider. Затова F2 дава 12.50, а null оставя квадратните скоби празни.
Примери
#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
};
}
}
Резултат
ID-0042 | 12.50 | []
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.