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

CKTIS / C#

ICustomFormatter.Format — oblikovanje vrednosti po meri

ICustomFormatter.Format ponudniku oblikovanja omogoča nadzor nad besedilno predstavitvijo vrednosti, ne da bi spremenil njen tip. Deluje z IFormatProvider in metodami, kot je string.Format; implementacija mora obravnavati tudi običajne oblike in null.

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

Sintaksa

string Format(string? format, object? arg, IFormatProvider? formatProvider);

ICustomFormatter.Format v imenskem prostoru System je povratni klic, ki se uporablja pri oblikovanju po meri. Za razliko od IFormattable, ki jo implementira oblikovani tip, omogoča določanje pravil zunaj tega tipa. API je na voljo v .NET 10; v tej različici ni novost in ne zahteva LangVersion=preview.

Metodi string.Format ali StringBuilder.AppendFormat posredujte IFormatProvider. Mehanizem z GetFormat(typeof(ICustomFormatter)) zahteva oblikovalnik. En razred lahko implementira oba vmesnika in vrne this. Nato se Format pokliče za vsak oblikovni element: pri {0:tag} prejme "tag" kot format, arg pa je argument z indeksom 0. Če specifikatorja ni, je format enak null; formatProvider označuje ponudnika storitve oblikovanja.

Obravnavajte svoje kombinacije tipa in oblike, druge primere pa prepustite IFormattable.ToString(format, provider) ali metodi ToString() brez parametrov. Če je arg == null, vrnite prazen niz. Neveljavna oblika, posredovana nadomestnemu oblikovanju, lahko povzroči FormatException; oblikovalnik po meri te napake ne bi smel nepremišljeno prikriti.

Primer prepozna "tag" samo za int. Za druge vrednosti izrecno uporablja CultureInfo.InvariantCulture namesto zanašanja na trenutno kulturo ali parameter formatProvider. Zato F2 ustvari 12.50, null pa pusti oglate oklepaje prazne.

Primeri

#nullable enable
using System;
using System.Globalization;

Console.WriteLine(string.Format(new LabelFormatter(),
    "{0:tag} | {1:F2} | [{2}]", 42, 12.5m, (object?)null));

sealed class LabelFormatter : IFormatProvider, ICustomFormatter
{
    public object? GetFormat(Type? formatType) =>
        formatType == typeof(ICustomFormatter) ? this : null;

    public string Format(string? format, object? arg,
        IFormatProvider? formatProvider)
    {
        if (format == "tag" && arg is int number)
            return "ID-" + number.ToString("D4", CultureInfo.InvariantCulture);

        return arg switch
        {
            null => string.Empty,
            IFormattable formattable =>
                formattable.ToString(format, CultureInfo.InvariantCulture) ?? string.Empty,
            _ => arg.ToString() ?? string.Empty
        };
    }
}

Rezultat

ID-0042 | 12.50 | []

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

Viri