WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C#

IFormatProvider — Formatierungsinformationen bereitstellen

System.IFormatProvider stellt Informationen bereit, die beim Formatieren und Parsen verwendet werden. Seine einzige Methode, GetFormat, gibt ein Objekt des angeforderten Typs zurück oder null, wenn der Provider diesen Typ nicht unterstützt.

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

Syntax

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

System.IFormatProvider stellt Informationen bereit, mit denen Werte in Text formatiert und Texte in Werte geparst werden. Die Schnittstelle ist in .NET 10 verfügbar und erfordert keine Preview-Sprachfunktionen. Zu den Implementierungen gehören CultureInfo, NumberFormatInfo und DateTimeFormatInfo.

Die einzige Methode, IFormatProvider.GetFormat, hat die Signatur object? GetFormat(Type? formatType). Der Formatierungs- oder Parsingcode übergibt den Typ des benötigten Objekts, zum Beispiel typeof(NumberFormatInfo). Der Provider gibt ein Objekt dieses Typs zurück oder null, wenn er keines bereitstellen kann. Das Ergebnis ist kein formatierter Text.

Ein Provider und eine Formatzeichenfolge haben unterschiedliche Aufgaben: "F2" legt das Zahlenformat fest, während der Provider Regeln wie das Dezimaltrennzeichen bereitstellt. Übergeben Sie einen Provider explizit an eine passende Überladung von ToString, Parse oder TryParse, statt sich auf die aktuelle Kultur zu verlassen. Im Beispiel sorgt CultureInfo.InvariantCulture für das vorhersehbare Ergebnis 1234.50.

Beispiele

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

Ergebnis

True
1234.50

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen