CKTIS / C#
IFormattable — formater des valeurs avec un fournisseur de format
System.IFormattable définit la conversion d’une valeur en texte à l’aide d’une chaîne de format et d’un fournisseur d’informations de formatage. Il permet aux types personnalisés de participer au formatage composite, comme string.Format, au lieu de s’appuyer uniquement sur ToString() sans paramètre.
Version : .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 contient une méthode : IFormattable.ToString(string? format, IFormatProvider? formatProvider). Le paramètre format sélectionne la représentation de la valeur, tandis que formatProvider fournit des informations de formatage, comme le séparateur décimal. Il s’agit d’un contrat de bibliothèque disponible dans .NET 10, et non d’une fonctionnalité nécessitant C# en version preview.
Une implémentation doit prendre en charge "G" (format général) et null comme format par défaut. L’exemple traite aussi une chaîne vide comme "G", utilise CultureInfo.CurrentCulture lorsque le fournisseur vaut null et rejette les formats non pris en charge avec FormatException. Le type définit ses formats supplémentaires : implémenter l’interface ne prend pas automatiquement en charge tous les formats numériques.
La surcharge à deux paramètres ne remplace pas object.ToString(). Dans l’exemple, une surcharge distincte de ToString() sans paramètre délègue à l’implémentation commune. string.Format lui transmet le format d’un élément tel que {0:F2} ainsi que le fournisseur. Toutefois, un fournisseur doté de ICustomFormatter peut prendre en charge le formatage ; la méthode de l’objet est utilisée lorsque ce mécanisme ne traite pas la valeur.
Le type Distance prend en charge exactement "G" et "F2", ainsi que les valeurs par défaut null et chaîne vide. Il transmet le fournisseur lors du formatage de sa valeur decimal sous-jacente. Les deux appels utilisent CultureInfo.InvariantCulture : les lignes attendues sont donc 12.5 m et 12.50 m, quelle que soit la culture actuelle.
Exemples
#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)
};
}
}Résultat
12.5 m 12.50 m
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.