Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C#

FormattableString.Invariant — interpolacja z kulturą niezmienną

FormattableString.Invariant formatuje argumenty interpolowanego tekstu przy użyciu kultury niezmiennej i zwraca string. Pozwala uzyskać zapis liczb niezależny od bieżącej kultury, zachowując specyfikatory formatu.

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

Składnia

public static string Invariant(FormattableString formattable);

FormattableString.Invariant jest statyczną metodą z przestrzeni nazw System, dostępną w .NET 10. Przyjmuje FormattableString i zwraca string, formatując argumenty zgodnie z CultureInfo.InvariantCulture, a nie bieżącą kulturą.

Przekaż bezpośrednio wyrażenie interpolowane, np. FormattableString.Invariant($"{amount:F2}"), albo zachowaj je w zmiennej typu FormattableString. Taki obiekt przechowuje format i argumenty do późniejszego formatowania. Natomiast var text = $"{amount:F2}" tworzy string; nie można przekazać go do tej metody i odzyskać pierwotnych argumentów.

W przykładzie F2 wymusza dwie cyfry po separatorze dziesiętnym, a kultura niezmienna wybiera kropkę, dając amount=1234.50. Metoda nie zmienia bieżącej kultury. Dyrektywa using static System.FormattableString; pozwala skrócić wywołanie do Invariant(...).

Stosuj ten sposób do tekstu wymagającego zapisu niezależnego od kultury; interfejs użytkownika zwykle powinien respektować kulturę odbiorcy. Kultura niezmienna nie gwarantuje bezstratnego zapisu: F2 może zaokrąglać wartości, więc format trzeba dobrać do wymagań danych.

Przykłady

using System;

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

Wynik

amount=1234.50

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła