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.