CKTIS / C#
IFormattable — форматиране на стойности с доставчик на формат
System.IFormattable дефинира преобразуването на стойност в текст чрез низ за формат и доставчик на информация за форматиране. Това позволява на потребителски типове да участват в съставно форматиране, например чрез string.Format, вместо да разчитат само на ToString() без параметри.
Версия: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Синтаксис
public interface IFormattable
{
string ToString(string? format, IFormatProvider? formatProvider);
}System.IFormattable съдържа един метод: IFormattable.ToString(string? format, IFormatProvider? formatProvider). Параметърът format избира представянето на стойността, а formatProvider предоставя информация за форматиране, например десетичния разделител. Това е библиотечен договор, наличен в .NET 10, а не функция, за която е необходим C# във версия preview.
Една реализация трябва да поддържа "G" (общ формат) и null като формат по подразбиране. Примерът третира и празен низ като "G", използва CultureInfo.CurrentCulture, когато доставчикът е null, и отхвърля неподдържаните формати с FormatException. Типът определя допълнителните си формати: реализирането на интерфейса не осигурява автоматично поддръжка за всички числови формати.
Претоварването с два параметъра не заменя object.ToString(). В примера отделно предефиниране на ToString() без параметри делегира към общата реализация. string.Format ѝ предава формата на елемент като {0:F2} и доставчика. Доставчик с ICustomFormatter обаче може да поеме форматирането; методът на обекта се използва, когато този механизъм не обработи стойността.
Типът Distance поддържа точно "G" и "F2", както и стойностите по подразбиране null и празен низ. При форматирането на базовата стойност decimal той предава доставчика нататък. И двете извиквания използват CultureInfo.InvariantCulture, затова очакваните редове са 12.5 m и 12.50 m независимо от текущата култура.
Примери
#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)
};
}
}Резултат
12.5 m 12.50 m
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.