Интерполяция строк и String.Format в C#: форматы, выравнивание, культура

Интерполяция строк собирает строку из буквального текста и выражений. Поставьте перед литералом $, поместите любое выражение C# в фигурные скобки, и его значение будет преобразовано в текст и подставлено:

using System;

class Program
{
    static void Main()
    {
        string customer = "Maya";
        int items = 3;
        decimal price = 4.5m;

        Console.WriteLine($"Hello, {customer}!");
        Console.WriteLine($"{items} items at {price} = {items * price}");
        Console.WriteLine($"Name has {customer.Length} letters, upper: {customer.ToUpper()}");
        Console.WriteLine($"Free shipping: {(items * price > 10 ? "yes" : "no")}");
    }
}

Вывод:

Hello, Maya!
3 items at 4.5 = 13.5
Name has 4 letters, upper: MAYA
Free shipping: yes

Интерполяция появилась в C# 6. Компилятор превращает её в вызов string.Format или string.Concat (а начиная с C# 10 в более эффективный код обработчика), поэтому она не медленнее, чем сборка строки вручную.

Условному выражению в последней строке нужны скобки. Внутри интерполяционной вставки двоеточие начинает спецификатор формата, поэтому {x > 10 ? "yes" : "no"} без скобок вызывает ошибку компиляции.

Спецификаторы формата

После выражения двоеточие и строка формата определяют, как записывается значение. Те же строки формата работают с ToString("...") и string.Format.

using System;

class Program
{
    static void Main()
    {
        decimal total = 1234567.891m;
        int orderId = 42;
        double ratio = 0.8127;

        Console.WriteLine($"{total:F2}");     // fixed-point, 2 decimals
        Console.WriteLine($"{total:N2}");     // with thousands separators
        Console.WriteLine($"{total:N0}");     // no decimals, rounded
        Console.WriteLine($"{orderId:D5}");   // integer padded to 5 digits
        Console.WriteLine($"{255:X}");        // hexadecimal
        Console.WriteLine($"{255:x4}");       // lowercase hex, 4 digits
        Console.WriteLine($"{total:E2}");     // scientific
        Console.WriteLine($"{ratio:F3}");
        Console.WriteLine($"{ratio:0.0%}");   // custom: percent with 1 decimal
        Console.WriteLine($"{total:#,##0.00}"); // custom pattern
        Console.WriteLine($"{7.5:000.0}");    // leading zeros
        Console.WriteLine($"{3.10m:0.##}");   // drop trailing zeros
    }
}

Вывод:

1234567.89
1,234,567.89
1,234,568
00042
FF
00ff
1.23E+006
0.813
81.3%
1,234,567.89
007.5
3.1

Стандартные коды, за каждым из которых может следовать число точности:

Пользовательские шаблоны строят формат из заполнителей: 0 это цифра, которая показывается всегда, # это цифра, которая показывается только если она значима, . это десятичный разделитель, , внутри числа включает разделители групп, а % умножает на 100. "0.##" показывает до двух знаков после запятой и убирает нули в конце; "#,##0.00" это классический бухгалтерский формат.

Всё числовое форматирование округляет отображаемое значение; сама переменная не меняется. Когда значение находится ровно посередине (2.25 с одним знаком после запятой), разные среды выполнения и типы могут округлять такой случай по-разному, поэтому если правило важно, сначала явно округлите через Math.Round(value, 1, MidpointRounding.AwayFromZero), а затем форматируйте.

Даты в интерполяции

Значения DateTime так же принимают строки формата дат:

using System;

class Program
{
    static void Main()
    {
        var shipped = new DateTime(2026, 9, 24, 16, 5, 0);

        Console.WriteLine($"{shipped:yyyy-MM-dd}");
        Console.WriteLine($"{shipped:dd/MM/yyyy HH:mm}");
        Console.WriteLine($"{shipped:ddd, MMM d}");
        Console.WriteLine($"Shipped at {shipped:HH:mm} on {shipped:dddd}");

        TimeSpan eta = TimeSpan.FromMinutes(130);
        Console.WriteLine($"ETA {eta:hh\\:mm}");
        Console.WriteLine($"{eta.TotalHours:F1} hours");
    }
}

Вывод:

2026-09-24
24/09/2026 16:05
Thu, Sep 24
Shipped at 16:05 on Thursday
ETA 02:10
2.2 hours

Пользовательский формат TimeSpan требует экранировать буквальные символы обратным слешем, который в обычном строковом литерале записывается как \\:. Полный список кодов дат (yyyy, MM, HH, tt...) и ошибки, которые с ними допускают (mm это минуты, MM это месяцы), на странице формат DateTime.

Выравнивание и дополнение

Запятая после выражения задаёт минимальную ширину поля. Положительное число выравнивает по правому краю, отрицательное по левому. Вместе с форматом это выстраивает таблицы в обычном тексте:

using System;

class Program
{
    static void Main()
    {
        var names = new[] { "Espresso", "Latte", "Hot chocolate" };
        var prices = new[] { 2.4m, 3.6m, 4.25m };
        var sold = new[] { 118, 64, 9 };

        Console.WriteLine($"{"Item",-14}|{"Price",7}|{"Sold",5}");
        Console.WriteLine(new string('-', 28));
        for (int i = 0; i < names.Length; i++)
        {
            Console.WriteLine($"{names[i],-14}|{prices[i],7:F2}|{sold[i],5}");
        }
    }
}

Вывод:

Item          |  Price| Sold
----------------------------
Espresso      |   2.40|  118
Latte         |   3.60|   64
Hot chocolate |   4.25|    9

Синтаксис такой: {expression,alignment:format}, сначала выравнивание, затем формат. Значение длиннее ширины не обрезается; оно сдвигает остаток строки. PadLeft и PadRight делают такое же дополнение вне интерполяции.

Экранирование фигурных скобок

Чтобы напечатать буквальную скобку, удвойте её: {{ и }}. Это нужно, когда вывод это JSON, CSS или код:

using System;

class Program
{
    static void Main()
    {
        int id = 42;
        string name = "Ana";

        Console.WriteLine($"{{ \"id\": {id}, \"name\": \"{name}\" }}");
        Console.WriteLine($"Set literal: {{1, 2, 3}}");
        Console.WriteLine($"{{{id}}}");   // a value wrapped in braces
    }
}

Вывод:

{ "id": 42, "name": "Ana" }
Set literal: {1, 2, 3}
{42}

Собирать JSON вручную вот так нормально для быстрой строки в логе; для настоящего JSON используйте сериализатор, который правильно обработает кавычки и специальные символы внутри name.

string.Format и составное форматирование

До C# 6 форматирование выполняли через string.Format, который принимает нумерованные заполнители и список аргументов. Тот же синтаксис составного форматирования принимают Console.WriteLine, StringBuilder.AppendFormat и TextWriter.Write:

using System;

class Program
{
    static void Main()
    {
        string item = "Notebook";
        decimal price = 3.5m;
        int qty = 4;

        string line = string.Format("{0} x{1}: {2:F2}", item, qty, price * qty);
        Console.WriteLine(line);

        Console.WriteLine("{0,-10}|{1,6:F2}", item, price);   // alignment and format
        Console.WriteLine("{0} {0} {1}", "echo", "!");        // an index can repeat

        string template = "Dear {0}, your order #{1:D6} has shipped.";
        Console.WriteLine(string.Format(template, "Leo", 731));
    }
}

Вывод:

Notebook x4: 14.00
Notebook  |  3.50
echo echo !
Dear Leo, your order #000731 has shipped.

В коде предпочитайте интерполяцию: значения стоят там, где они появляются, поэтому заполнитель не может указать на не тот аргумент. string.Format остаётся правильным инструментом, когда шаблон это данные, например переведённое сообщение, загруженное из файла ресурсов. Индекс заполнителя без соответствующего аргумента ({2} при двух аргументах) выбрасывает FormatException во время выполнения.

Культура: управление разделителями и валютой

Интерполяция, ToString и string.Format по умолчанию используют текущую культуру потока. На машине с немецкими настройками {1234.5:N2} даёт 1.234,50; в США 1,234.50. Формат валюты C использует символ культуры. Чтобы выбрать культуру явно, сохраните интерполированную строку как FormattableString и отформатируйте её с поставщиком формата:

using System;
using System.Globalization;

class Program
{
    static void Main()
    {
        decimal amount = 1234.5m;
        var us = new CultureInfo("en-US");
        var de = new CultureInfo("de-DE");

        FormattableString line = $"Total: {amount:N2}";
        Console.WriteLine(line.ToString(us));
        Console.WriteLine(line.ToString(de));

        Console.WriteLine(amount.ToString("C", us));
        Console.WriteLine(string.Format(de, "{0:N2}", amount));

        // For files, logs and URLs: always the invariant culture
        string csv = FormattableString.Invariant($"{amount},{0.75}");
        Console.WriteLine(csv);
    }
}

Вывод:

Total: 1,234.50
Total: 1.234,50
$1,234.50
1.234,50
1234.5,0.75

Используйте культуру пользователя для текста, который читают люди, и CultureInfo.InvariantCulture для всего, что читает другая программа. CSV, записанный с текущей культурой на немецкой машине, содержит запятые внутри чисел и не читается в других местах. В .NET 6 и новее string.Create(CultureInfo.InvariantCulture, $"...") делает то же, что FormattableString.Invariant, без промежуточного объекта.

Verbatim и необработанные интерполированные строки

$ сочетается с @ в verbatim-интерполированной строке: обратные слеши буквальные, и строка может занимать несколько строк. C# 8 и новее принимают любой порядок ($@ или @$); C# 6 и 7 требуют $@:

using System;

class Program
{
    static void Main()
    {
        string user = "ana";
        int year = 2026;
        Console.WriteLine($@"C:\Users\{user}\Reports\{year}\summary.txt");
        Console.WriteLine($@"Report for {user}
Year: {year}");
    }
}

Вывод:

C:\Users\ana\Reports\2026\summary.txt
Report for ana
Year: 2026

C# 11 добавил необработанные интерполированные строки. С одним $ скобки, как обычно, обозначают выражения. С $$ одиночная скобка становится буквальной, а выражениям нужны две скобки, что делает шаблоны JSON и кода читаемыми:

// C# 11 and later
int id = 42;
string name = "Ana";
string json = $$"""
    {
      "id": {{id}},
      "name": "{{name}}"
    }
    """;

C# 11 также разрешает переводы строк внутри интерполяционной вставки, поэтому длинное выражение или switch-выражение можно разбить на несколько строк.

Частые ошибки

• Забытый $. "Total: {total}" печатает скобки буквально. Компилятор не предупреждает.
• Тернарный оператор без скобок внутри вставки: двоеточие читается как разделитель формата.
• Форматирование машиночитаемого вывода с текущей культурой. Десятичные запятые ломают CSV, JSON и SQL. Используйте инвариантную культуру.
• ToString() без формата для денег. 2.5m печатается как 2.5, а не 2.50. Используйте F2, N2 или C.
• Сборка больших строк интерполяцией в цикле. Каждая итерация создаёт новую строку; используйте StringBuilder или string.Join.