База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C#

FormattableString.Invariant — интерполация с инвариантна култура

FormattableString.Invariant форматира аргументите на интерполиран низ с инвариантната култура и връща низ. Така числовото представяне не зависи от текущата култура, като зададените спецификатори за формат се запазват.

Версия: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Синтаксис

public static string Invariant(FormattableString formattable);

FormattableString.Invariant е статичен метод в пространството от имена System, наличен в .NET 10. Приема FormattableString и връща string, като форматира аргументите с CultureInfo.InvariantCulture, а не с текущата култура.

Подайте му директно интерполиран израз, например FormattableString.Invariant($"{amount:F2}"), или го запазете в променлива от тип FormattableString. Този обект съхранява формата и аргументите за по-късно форматиране. За разлика от него, var text = $"{amount:F2}" създава string; не можете да подадете този низ на метода и да възстановите първоначалните аргументи.

В примера F2 изисква две цифри след десетичния разделител, а инвариантната култура избира точка, така че резултатът е amount=1234.50. Методът не променя текущата култура. Директивата using static System.FormattableString; позволява да съкратите извикването до Invariant(...).

Използвайте този подход за текст, чието форматиране трябва да е независимо от културата; потребителските интерфейси обикновено трябва да се съобразяват с културата на аудиторията. Инвариантната култура не гарантира съхранение без загуба: F2 може да закръгли стойности. Затова изберете формат, подходящ за изискванията към данните.

Примери

using System;

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

Резултат

amount=1234.50

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници