Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C#

IFormatProvider — fournir des informations de formatage

System.IFormatProvider fournit les informations utilisées lors du formatage et de l’analyse. Son unique méthode, GetFormat, renvoie un objet du type demandé ou null si le fournisseur ne prend pas en charge ce type.

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

Syntaxe

public interface IFormatProvider
{
    object? GetFormat(Type? formatType);
}

System.IFormatProvider fournit des informations permettant de formater des valeurs en texte et d’analyser du texte pour obtenir des valeurs. Cette interface est disponible dans .NET 10 et ne nécessite aucune fonctionnalité de langage en preview. CultureInfo, NumberFormatInfo et DateTimeFormatInfo en sont des implémentations.

Son unique méthode, IFormatProvider.GetFormat, a la signature object? GetFormat(Type? formatType). Le code de formatage ou d’analyse transmet le type de l’objet dont il a besoin, par exemple typeof(NumberFormatInfo). Le fournisseur renvoie un objet de ce type, ou null s’il ne peut pas en fournir. Le résultat n’est pas du texte formaté.

Un fournisseur et une chaîne de format ont des rôles différents : "F2" définit le format numérique, tandis que le fournisseur fournit des règles telles que le séparateur décimal. Transmettez explicitement un fournisseur à une surcharge appropriée de ToString, Parse ou TryParse, plutôt que de dépendre de la culture actuelle. Dans l’exemple, CultureInfo.InvariantCulture garantit le résultat prévisible 1234.50.

Exemples

using System;
using System.Globalization;

IFormatProvider provider = CultureInfo.InvariantCulture;
object? format = provider.GetFormat(typeof(NumberFormatInfo));

Console.WriteLine(format is NumberFormatInfo);
Console.WriteLine(1234.5m.ToString("F2", provider));

Résultat

True
1234.50

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.

Sources