База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C#

Форматиране на Price с IFormattable, IFormatProvider и NumberFormatInfo

Определи договора на `Price.ToString`, предай числовите настройки на `decimal` и промени десетичния разделител в копие, което позволява запис, а не в оригинала.

Версия: C# 12 and .NET 8; later runtimes may add compatible features

Синтаксис

System.IFormattable: string ToString(string? format, IFormatProvider? formatProvider);
System.IFormatProvider: object? GetFormat(Type? formatType);
System.Globalization.NumberFormatInfo: public object Clone();
Writable copy: var copy = (NumberFormatInfo)source.Clone();
Direct call: price.ToString("F2", copy)
Composite call: string.Format(copy, "{0:F2}", price)

System.IFormattable дефинира метода ToString(format, formatProvider) с два аргумента. Реализацията трябва да поддържа общия формат G и да приема null за избор на формат по подразбиране. Методът ToString() без параметри е отделно предефиниране на object.ToString(). В примера той извиква същата реализация с null и за двата аргумента.

Price определя кои формати приема: null, празният низ, G и g избират общия формат на decimal; F2 и f2 дават точно две цифри след десетичния разделител, без групиране на цифрите и без символ за валута. Другите формати предизвикват FormatException. Форматирането променя текста, а не съхранената сума.

System.IFormatProvider предоставя настройки, но не форматира сумата. GetFormat(Type?) връща обект от заявения тип или null, ако не може да го предостави. При форматиране на decimal обектът CultureInfo предоставя своите настройки NumberFormat, а System.Globalization.NumberFormatInfo може да върне самия себе си. Ако доставчикът е null или не предоставя числови настройки, decimal използва текущата култура. В примера string.Format предава F2 и копието на реализацията на IFormattable.ToString в Price.

NumberFormatInfo.InvariantInfo е само за четене: опитът да се зададе NumberDecimalSeparator в него предизвиква InvalidOperationException. Clone() връща плитко копие, което позволява запис, като object. Преобразувай го изрично към NumberFormatInfo и промени разделителя в копието. Предаването на копието при извикване не променя оригинала или текущата култура.

Примери

#nullable enable
using System;
using System.Globalization;

var price = new Price(1234.5m);
var original = NumberFormatInfo.InvariantInfo;
var copy = (NumberFormatInfo)original.Clone();
copy.NumberDecimalSeparator = ",";

IFormattable formattable = price;
Console.WriteLine(formattable.ToString(null, original));
Console.WriteLine(string.Format(copy, "{0:F2}", price));
Console.WriteLine(price.ToString("F2", original));

public sealed class Price(decimal amount) : IFormattable
{
    public override string ToString() => ToString(null, null);

    public string ToString(string? format, IFormatProvider? formatProvider)
        => format switch
        {
            null or "" or "G" or "g" => amount.ToString("G", formatProvider),
            "F2" or "f2" => amount.ToString("F2", formatProvider),
            _ => throw new FormatException("Unsupported Price format.")
        };
}

Резултат

1234.5
1234,50
1234.50

Първият ред показва формата по подразбиране, избран чрез `null`. Последните два използват `F2`: запетаята идва от копието, а точката — от непроменения оригинал.

Свързани уроци

  • C# · Урок 33 · Средно · Версия: 2

Източници