CKTIS / C#
Prilagođeno oblikovanje u .NET-u: pružatelj, oblikovatelj i tip
Razlikuj tri ugovora oblikovanja: pronalaženje usluge, obradu stavke formata i pretvaranje vrijednosti u tekst prema pravilima njezina tipa.
Verzija: C# 12 and .NET 8; later runtimes may add compatible features
Sintaksa
C# 12 / .NET 8, namespace System
IFormatProvider: object? GetFormat(Type? formatType);
ICustomFormatter: string Format(string? format, object? arg, IFormatProvider? formatProvider);
IFormattable: string ToString(string? format, IFormatProvider? formatProvider);
Composite formatting: string.Format(provider, "{0:code}", value)
Direct call: ((IFormattable)value).ToString("G", provider)U C# 12 i .NET 8 sva su tri sučelja u imenskom prostoru System. Preopterećenje metode string.Format koje prima pružatelja poziva IFormatProvider.GetFormat(Type?) s typeof(ICustomFormatter), a ne s tipom vrijednosti koja se oblikuje. Pružatelj vraća uslugu traženog tipa ili null. Ako sam implementira uslugu, može vratiti this. Pronađeni se oblikovatelj ponovno koristi unutar istog poziva.
Za {0:F2}, ICustomFormatter.Format prima "F2", argument na indeksu nula i pružatelja. U {0} nema koda formata pa metoda prima null. Bilo koji vraćeni niz, pa i "", dovršava obradu stavke. Ako metoda vrati null, ovo preopterećenje metode string.Format nastavlja s uobičajenim oblikovanjem. Znak ! u null! samo potiskuje upozorenje o mogućoj vrijednosti null: metoda i dalje vraća null, iako joj je povratni tip string.
Ako nema prilagođenog oblikovatelja ili on ne obradi stavku, string.Format u .NET-u 8 može najprije pokušati oblikovati argument pozivom ISpanFormattable.TryFormat. Ako se taj korak preskoči ili TryFormat vrati false, argument različit od null koji implementira IFormattable oblikuje se pozivom IFormattable.ToString(format, provider). Za ostale argumente različite od null rabi se ToString() bez parametara, koji ne prima kod formata. Argument null koji dođe do uobičajenog oblikovanja obrađuje se kao prazan niz prije eventualnog dodavanja razmaka radi poravnanja. Za "G" i null implementiraj opći format. Tip može baciti FormatException za nepodržani kôd; string.Format može neovisno baciti istu iznimku, primjerice za indeks izvan popisa argumenata.
Izravni poziv metode ToString s dva argumenta ne poziva automatski ICustomFormatter. Tip i dalje može upotrijebiti pružatelja, primjerice da putem GetFormat dohvati NumberFormatInfo ili DateTimeFormatInfo. Unutar Format nemoj ponovo zvati string.Format s istim pružateljem, argumentom i kodom: mogao bi ponovno ući u isti oblikovatelj.
Primjeri
#nullable enable
using System;
using System.Globalization;
var provider = new ReadingFormatProvider();
var reading = new Voltage(12.5m);
Console.WriteLine(string.Format(provider, "{0:bracket} | {0:F2} | {0}", reading));
sealed class ReadingFormatProvider : IFormatProvider, ICustomFormatter
{
public object? GetFormat(Type? formatType) =>
formatType == typeof(ICustomFormatter)
? this
: CultureInfo.InvariantCulture.GetFormat(formatType);
public string Format(string? format, object? arg, IFormatProvider? formatProvider)
{
if (format == "bracket" && arg is Voltage voltage)
return "[" + voltage.ToString("F2", formatProvider) + "]";
return null!; // string.Format continues with ordinary formatting.
}
}
sealed class Voltage(decimal volts) : IFormattable
{
public override string ToString() => ToString("G", null);
public string ToString(string? format, IFormatProvider? formatProvider) =>
(format switch
{
null or "G" => volts.ToString("G", formatProvider),
"F2" => volts.ToString("F2", formatProvider),
_ => throw new FormatException($"Unsupported voltage format: {format}")
}) + " V";
}Rezultat
[12.50 V] | 12.50 V | 12.5 V
Oblikovatelj obrađuje `bracket` za `Voltage` tako da izravno pozove `ToString("F2", formatProvider)` i doda uglate zagrade. Preostale dvije stavke obrađuje `Voltage.ToString`. Pružatelj prosljeđuje zahtjeve za kulturalnim podacima objektu `CultureInfo.InvariantCulture`, pa je decimalni razdjelnik točka.
Povezane lekcije
- C# · Lekcija 33 · Napredno · Verzija: 3