Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C#

IFormattable — formátování hodnot pomocí poskytovatele formátu

System.IFormattable definuje převod hodnoty na text pomocí formátovacího řetězce a poskytovatele informací o formátování. Umožňuje vlastním typům účastnit se složeného formátování, například string.Format, místo spoléhání pouze na bezparametrické ToString().

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

Syntaxe

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

System.IFormattable obsahuje jednu metodu: IFormattable.ToString(string? format, IFormatProvider? formatProvider). Parametr format vybírá reprezentaci hodnoty, zatímco formatProvider poskytuje informace o formátování, například desetinný oddělovač. Jde o knihovní kontrakt dostupný v .NET 10, nikoli o funkci vyžadující C# ve verzi preview.

Implementace musí podporovat "G" (obecný formát) a null jako výchozí formát. Příklad považuje za "G" také prázdný řetězec, při hodnotě poskytovatele null používá CultureInfo.CurrentCulture a nepodporované formáty odmítá pomocí FormatException. Další formáty určuje typ: implementace rozhraní automaticky nezajišťuje podporu všech číselných formátů.

Přetížení se dvěma parametry nenahrazuje object.ToString(). V příkladu samostatné přepsání bezparametrického ToString() deleguje na společnou implementaci. string.Format jí předává formát položky, například {0:F2}, a poskytovatele. Poskytovatel s ICustomFormatter však může formátování převzít; metoda objektu se použije, pokud tento mechanismus hodnotu nezpracuje.

Typ Distance podporuje přesně "G" a "F2" a také výchozí hodnoty null a prázdný řetězec. Při formátování podkladové hodnoty decimal předává poskytovatele dál. Obě volání používají CultureInfo.InvariantCulture, takže očekávané řádky jsou 12.5 m a 12.50 m bez ohledu na aktuální jazykovou kulturu.

Pří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ýsledek

12.5 m
12.50 m

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje