KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C#

FormattableString.Invariant — interpolatie met invariant-cultuur

FormattableString.Invariant formatteert de argumenten van een geïnterpoleerde tekenreeks met de invariant-cultuur en retourneert een tekenreeks. Zo is de weergave van getallen onafhankelijk van de huidige cultuur, terwijl de opgegeven formaatspecificaties behouden blijven.

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

Syntax

public static string Invariant(FormattableString formattable);

FormattableString.Invariant is een statische methode in de naamruimte System, beschikbaar in .NET 10. De methode accepteert een FormattableString en retourneert een string. De argumenten worden geformatteerd met CultureInfo.InvariantCulture in plaats van met de huidige cultuur.

Geef rechtstreeks een geïnterpoleerde expressie door, zoals FormattableString.Invariant($"{amount:F2}"), of bewaar deze in een variabele van het type FormattableString. Dit object bewaart de indeling en argumenten voor latere opmaak. var text = $"{amount:F2}" maakt daarentegen een string; je kunt die niet aan deze methode doorgeven om de oorspronkelijke argumenten terug te krijgen.

In het voorbeeld vraagt F2 om twee decimalen en kiest de invariant-cultuur een punt als decimaalteken. Dat levert amount=1234.50 op. De methode verandert de huidige cultuur niet. Met de richtlijn using static System.FormattableString; kun je de aanroep verkorten tot Invariant(...).

Gebruik deze aanpak voor tekst waarvan de opmaak onafhankelijk moet zijn van de cultuur; gebruikersinterfaces horen doorgaans rekening te houden met de cultuur van het publiek. De invariant-cultuur garandeert geen verliesvrije opslag: F2 kan waarden afronden. Kies daarom een notatie die past bij de eisen voor de gegevens.

Voorbeelden

using System;

class Program
{
    static void Main()
    {
        decimal amount = 1234.5m;
        FormattableString template = $"amount={amount:F2}";
        Console.WriteLine(FormattableString.Invariant(template));
    }
}

Resultaat

amount=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