Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C#

IFormattable — oblikovanje vrijednosti pomoću pružatelja formata

System.IFormattable definira pretvorbu vrijednosti u tekst pomoću niza formata i pružatelja informacija o oblikovanju. Omogućuje prilagođenim tipovima sudjelovanje u složenom oblikovanju, primjerice putem string.Format, umjesto oslanjanja samo na bezparametarski ToString().

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

Sintaksa

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

System.IFormattable sadrži jednu metodu: IFormattable.ToString(string? format, IFormatProvider? formatProvider). Parametar format odabire prikaz vrijednosti, dok formatProvider pruža informacije o oblikovanju, primjerice decimalni separator. To je ugovor biblioteke dostupan u .NET 10, a ne značajka za koju je potreban C# u verziji preview.

Implementacija mora podržavati "G" (opći format) i null kao zadani format. Primjer tretira i prazan niz kao "G", upotrebljava CultureInfo.CurrentCulture kada je pružatelj null te odbacuje nepodržane formate pomoću FormatException. Dodatne formate određuje tip: implementacija sučelja ne podrazumijeva automatsku podršku za sve numeričke formate.

Preopterećenje s dva parametra ne zamjenjuje object.ToString(). U primjeru zasebna nadjačana bezparametarska metoda ToString() delegira zajedničkoj implementaciji. string.Format prosljeđuje joj format stavke kao što je {0:F2} i pružatelja. No pružatelj s ICustomFormatter može preuzeti oblikovanje; metoda objekta koristi se kada taj mehanizam ne obradi vrijednost.

Tip Distance podržava točno "G" i "F2", kao i zadane vrijednosti null i prazan niz. Pri oblikovanju temeljne vrijednosti decimal prosljeđuje pružatelja. Oba poziva koriste CultureInfo.InvariantCulture, pa su očekivani retci 12.5 m i 12.50 m, neovisno o trenutačnoj kulturi.

Primjeri

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

Rezultat

12.5 m
12.50 m

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori