KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C#

IFormatProvider — opmaakinformatie leveren

System.IFormatProvider levert informatie die wordt gebruikt bij het opmaken en parseren. De enige methode, GetFormat, retourneert een object van het gevraagde type of null als de provider dat type niet ondersteunt.

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

Syntax

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

System.IFormatProvider levert informatie voor het opmaken van waarden als tekst en het parseren van tekst naar waarden. De interface is beschikbaar in .NET 10 en vereist geen preview-taalfuncties. Implementaties zijn onder andere CultureInfo, NumberFormatInfo en DateTimeFormatInfo.

De enige methode, IFormatProvider.GetFormat, heeft de signatuur object? GetFormat(Type? formatType). De opmaak- of parseercode geeft het type van het benodigde object door, bijvoorbeeld typeof(NumberFormatInfo). De provider retourneert een object van dat type, of null als deze het niet kan leveren. Het resultaat is geen opgemaakte tekst.

Een provider en een opmaaktekenreeks hebben verschillende taken: "F2" bepaalt de getalnotatie, terwijl de provider regels zoals het decimaalteken levert. Geef expliciet een provider door aan een geschikte overload van ToString, Parse of TryParse, in plaats van te vertrouwen op de huidige cultuur. In het voorbeeld zorgt CultureInfo.InvariantCulture voor het voorspelbare resultaat 1234.50.

Voorbeelden

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));

Resultaat

True
1234.50

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen