Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C#

IFormatProvider — poskytování informací o formátování

System.IFormatProvider poskytuje informace používané při formátování a parsování. Jeho jediná metoda, GetFormat, vrací objekt požadovaného typu, nebo null, pokud poskytovatel tento typ nepodporuje.

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

Syntaxe

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

System.IFormatProvider poskytuje informace pro formátování hodnot jako textu a parsování textu na hodnoty. Je dostupné v .NET 10 a nevyžaduje jazykové funkce ve verzi preview. Mezi implementace patří CultureInfo, NumberFormatInfo a DateTimeFormatInfo.

Jeho jediná metoda, IFormatProvider.GetFormat, má signaturu object? GetFormat(Type? formatType). Kód pro formátování nebo parsování předá typ požadovaného objektu, například typeof(NumberFormatInfo). Poskytovatel vrátí objekt tohoto typu, nebo null, pokud jej nemůže poskytnout. Výsledkem není formátovaný text.

Poskytovatel a formátovací řetězec mají různé úlohy: "F2" určuje číselný formát, zatímco poskytovatel dodává pravidla, například oddělovač desetinných míst. Předejte poskytovatele výslovně vhodnému přetížení metody ToString, Parse nebo TryParse místo spoléhání na aktuální kulturu. V příkladu zajišťuje CultureInfo.InvariantCulture předvídatelný výsledek 1234.50.

Příklady

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

Výsledek

True
1234.50

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje