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

CKTIS / C#

FormattableString.Invariant — interpolace s invariantní kulturou

FormattableString.Invariant formátuje argumenty interpolovaného řetězce pomocí invariantní kultury a vrací řetězec. Číselný zápis tak nezávisí na aktuální kultuře a zadané specifikátory formátu zůstávají zachovány.

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

Syntaxe

public static string Invariant(FormattableString formattable);

FormattableString.Invariant je statická metoda v oboru názvů System, dostupná v .NET 10. Přijímá FormattableString a vrací string; argumenty formátuje pomocí CultureInfo.InvariantCulture, nikoli podle aktuální kultury.

Předejte jí přímo interpolovaný výraz, například FormattableString.Invariant($"{amount:F2}"), nebo jej uložte do proměnné typu FormattableString. Tento objekt uchovává formát a argumenty pro pozdější formátování. Naproti tomu var text = $"{amount:F2}" vytvoří string; nelze jej předat této metodě a získat zpět původní argumenty.

V příkladu F2 požaduje dvě desetinná místa a invariantní kultura zvolí desetinnou tečku, takže výsledkem je amount=1234.50. Metoda aktuální kulturu nemění. Direktiva using static System.FormattableString; umožňuje zkrátit volání na Invariant(...).

Tento postup použijte pro text, jehož formátování musí být nezávislé na kultuře; uživatelská rozhraní by obvykle měla respektovat kulturu publika. Invariantní kultura nezaručuje bezeztrátové uložení: F2 může hodnoty zaokrouhlit. Zvolte proto formát odpovídající požadavkům na data.

Příklady

using System;

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

Výsledek

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