Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C#

IFormattable — formátovanie hodnôt pomocou poskytovateľa formátu

System.IFormattable definuje prevod hodnoty na text pomocou formátovacieho reťazca a poskytovateľa informácií o formátovaní. Umožňuje vlastným typom zúčastňovať sa zloženého formátovania, napríklad string.Format, namiesto spoliehania sa iba na bezparametrické ToString().

Verzia: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Syntax

public interface IFormattable
{
    string ToString(string? format, IFormatProvider? formatProvider);
}

System.IFormattable obsahuje jednu metódu: IFormattable.ToString(string? format, IFormatProvider? formatProvider). Parameter format vyberá reprezentáciu hodnoty, zatiaľ čo formatProvider poskytuje informácie o formátovaní, napríklad desatinný oddeľovač. Ide o knižničný kontrakt dostupný v .NET 10, nie o funkciu vyžadujúcu C# vo verzii preview.

Implementácia musí podporovať "G" (všeobecný formát) a null ako predvolený formát. Príklad považuje za "G" aj prázdny reťazec, pri hodnote poskytovateľa null používa CultureInfo.CurrentCulture a nepodporované formáty odmieta pomocou FormatException. Ďalšie formáty určuje typ: implementácia rozhrania automaticky nezabezpečuje podporu všetkých číselných formátov.

Preťaženie s dvoma parametrami nenahrádza object.ToString(). V príklade samostatné prepísanie bezparametrického ToString() deleguje na spoločnú implementáciu. string.Format jej odovzdáva formát položky, napríklad {0:F2}, a poskytovateľa. Poskytovateľ s ICustomFormatter však môže formátovanie prevziať; metóda objektu sa použije, keď tento mechanizmus hodnotu nespracuje.

Typ Distance podporuje presne "G" a "F2" a tiež predvolené hodnoty null a prázdny reťazec. Pri formátovaní podkladovej hodnoty decimal odovzdáva poskytovateľa ďalej. Obe volania používajú CultureInfo.InvariantCulture, takže očakávané riadky sú 12.5 m a 12.50 m bez ohľadu na aktuálnu kultúru.

Príklady

#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)
        };
    }
}

Výsledok

12.5 m
12.50 m

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje