Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C#

IFormattable — oblikovanje vrednosti s ponudnikom oblikovanja

System.IFormattable določa pretvorbo vrednosti v besedilo z nizom oblike in ponudnikom informacij za oblikovanje. Lastnim tipom omogoča sodelovanje pri sestavljenem oblikovanju, na primer s string.Format, namesto da bi se zanašali le na brezparametrski ToString().

Različica: .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 vsebuje eno metodo: IFormattable.ToString(string? format, IFormatProvider? formatProvider). Parameter format izbere predstavitev vrednosti, formatProvider pa zagotovi informacije za oblikovanje, na primer decimalno ločilo. To je knjižnična pogodba, ki je na voljo v .NET 10, in ne funkcija, za katero bi potrebovali C# v različici preview.

Implementacija mora podpirati "G" (splošna oblika) in null kot privzeto obliko. Primer obravnava prazen niz tudi kot "G", pri ponudniku null uporabi CultureInfo.CurrentCulture in nepodprte oblike zavrne z FormatException. Dodatne oblike določa tip: implementacija vmesnika ne zagotavlja samodejne podpore za vse številske oblike.

Preobremenitev z dvema parametroma ne nadomesti object.ToString(). V primeru ločena preglasitev brezparametrskega ToString() pokliče skupno implementacijo. string.Format ji posreduje obliko elementa, kot je {0:F2}, in ponudnika. Ponudnik z ICustomFormatter pa lahko prevzame oblikovanje; metoda objekta se uporabi, kadar ta mehanizem vrednosti ne obdela.

Tip Distance podpira natanko "G" in "F2" ter privzeti vrednosti null in prazen niz. Pri oblikovanju osnovne vrednosti decimal posreduje ponudnika naprej. Oba klica uporabljata CultureInfo.InvariantCulture, zato sta pričakovani vrstici 12.5 m in 12.50 m, ne glede na trenutno kulturo.

Primeri

#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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri