Nội suy chuỗi và String.Format trong C#: định dạng, căn lề, culture

Nội suy chuỗi (string interpolation) tạo một chuỗi từ văn bản cố định và các biểu thức. Thêm tiền tố $ cho literal, đặt bất kỳ biểu thức C# nào trong dấu ngoặc nhọn, và giá trị của nó sẽ được chuyển thành văn bản rồi chèn vào:

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")}");
    }
}

Đầu ra:

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

Nội suy chuỗi có từ C# 6. Trình biên dịch biến nó thành lời gọi string.Format hoặc string.Concat (hoặc, từ C# 10, thành code handler hiệu quả hơn), nên nó không chậm hơn việc tự ghép chuỗi.

Biểu thức điều kiện ở dòng cuối cần dấu ngoặc đơn. Bên trong một chỗ nội suy, dấu hai chấm bắt đầu format specifier, nên {x > 10 ? "yes" : "no"} không có ngoặc đơn sẽ là lỗi biên dịch.

Format specifier

Sau biểu thức, một dấu hai chấm và một chuỗi định dạng quyết định cách giá trị được viết ra. Các chuỗi định dạng này cũng dùng được với ToString("...") và 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
    }
}

Đầu ra:

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

Các mã chuẩn, mỗi mã có thể kèm theo một số chỉ độ chính xác:

Mẫu tùy chỉnh tạo định dạng từ các ký hiệu giữ chỗ: 0 là chữ số luôn được hiển thị, # là chữ số chỉ hiển thị khi có nghĩa, . là dấu thập phân, , bên trong số bật dấu phân cách nhóm, và % nhân với 100. "0.##" hiển thị tối đa hai chữ số thập phân và bỏ các số 0 thừa ở cuối; "#,##0.00" là định dạng kế toán kinh điển.

Mọi định dạng số đều làm tròn giá trị hiển thị; bản thân biến không thay đổi. Khi một giá trị nằm đúng ở giữa (2.25 hiển thị với một chữ số thập phân), các runtime và kiểu khác nhau có thể làm tròn khác nhau, nên nếu quy tắc này quan trọng, hãy làm tròn tường minh trước bằng Math.Round(value, 1, MidpointRounding.AwayFromZero) rồi mới định dạng.

Ngày giờ trong nội suy chuỗi

Giá trị DateTime nhận chuỗi định dạng ngày theo cùng cách:

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");
    }
}

Đầu ra:

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

Định dạng tùy chỉnh của TimeSpan yêu cầu các ký tự cố định phải được thoát bằng dấu gạch chéo ngược, mà trong string literal thông thường được viết là \\:. Danh sách đầy đủ các mã ngày (yyyy, MM, HH, tt...) và những lỗi hay mắc với chúng (mm là phút, MM là tháng) có ở trang định dạng DateTime.

Căn lề và đệm khoảng trắng

Dấu phẩy sau biểu thức đặt độ rộng tối thiểu cho trường. Số dương căn phải, số âm căn trái. Kết hợp với định dạng, nó giúp căn thẳng bảng ở dạng văn bản thuần:

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}");
        }
    }
}

Đầu ra:

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

Cú pháp là {expression,alignment:format}: căn lề trước, định dạng sau. Giá trị dài hơn độ rộng không bị cắt bớt; nó đẩy phần còn lại của dòng sang bên. PadLeft và PadRight đệm theo cùng cách khi không dùng nội suy.

Thoát dấu ngoặc nhọn

Để in ra dấu ngoặc nhọn, hãy viết gấp đôi: {{ và }}. Điều này thường gặp khi đầu ra là JSON, CSS hoặc code:

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
    }
}

Đầu ra:

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

Tự ghép JSON như thế này thì được cho một dòng log nhanh; với JSON thật, hãy dùng một thư viện serialize, nó xử lý đúng dấu ngoặc kép và ký tự đặc biệt bên trong name.

string.Format và composite formatting

Trước C# 6, việc định dạng được thực hiện bằng string.Format, nhận các chỗ giữ chỗ được đánh số và một danh sách đối số. Cú pháp composite format này cũng được Console.WriteLine, StringBuilder.AppendFormat và TextWriter.Write chấp nhận:

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));
    }
}

Đầu ra:

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

Trong code, hãy ưu tiên nội suy: giá trị nằm ngay tại vị trí nó xuất hiện, nên chỗ giữ chỗ không thể trỏ nhầm đối số. string.Format vẫn là công cụ đúng khi mẫu chuỗi là dữ liệu, như một thông điệp đã dịch được nạp từ tệp tài nguyên. Chỉ số giữ chỗ không có đối số tương ứng ({2} với hai đối số) sẽ ném FormatException lúc chạy.

Culture: kiểm soát dấu phân cách và tiền tệ

Nội suy, ToString và string.Format mặc định đều dùng culture hiện tại của luồng. Trên máy cài đặt tiếng Đức, {1234.5:N2} cho ra 1.234,50; ở Mỹ thì cho ra 1,234.50. Định dạng tiền tệ C dùng ký hiệu của culture. Để chọn culture tường minh, hãy giữ chuỗi nội suy dưới dạng FormattableString rồi định dạng nó với một provider:

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);
    }
}

Đầu ra:

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

Hãy dùng culture của người dùng cho văn bản người đọc, và CultureInfo.InvariantCulture cho mọi thứ mà chương trình khác đọc. Một tệp CSV được ghi theo culture hiện tại trên máy tiếng Đức sẽ có dấu phẩy bên trong các số và không đọc được ở nơi khác. Từ .NET 6 trở đi, string.Create(CultureInfo.InvariantCulture, $"...") làm điều tương tự FormattableString.Invariant mà không tạo đối tượng trung gian.

Chuỗi nội suy verbatim và raw

$ kết hợp với @ thành chuỗi nội suy verbatim: dấu gạch chéo ngược được giữ nguyên và chuỗi có thể trải trên nhiều dòng. Từ C# 8 chấp nhận cả hai thứ tự ($@ hoặc @$); C# 6 và 7 bắt buộc $@:

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}");
    }
}

Đầu ra:

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

C# 11 bổ sung chuỗi nội suy raw. Với một $, dấu ngoặc nhọn đánh dấu biểu thức như thường lệ. Với $$, dấu ngoặc nhọn đơn là ký tự thường và biểu thức cần hai dấu ngoặc nhọn, giúp các mẫu JSON và code dễ đọc hơn:

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

C# 11 cũng cho phép xuống dòng bên trong một chỗ nội suy, nên biểu thức dài hoặc biểu thức switch có thể được chia ra nhiều dòng.

Lỗi thường gặp

• Quên $. "Total: {total}" in nguyên văn cả dấu ngoặc nhọn. Trình biên dịch không cảnh báo.
• Toán tử ba ngôi không có dấu ngoặc đơn bên trong dấu ngoặc nhọn: dấu hai chấm bị hiểu là dấu phân cách định dạng.
• Định dạng đầu ra cho máy đọc theo culture hiện tại. Dấu phẩy thập phân làm hỏng CSV, JSON và SQL. Hãy dùng invariant culture.
• Dùng ToString() không kèm định dạng cho tiền. 2.5m in ra 2.5, không phải 2.50. Hãy dùng F2, N2 hoặc C.
• Tạo chuỗi lớn bằng nội suy trong vòng lặp. Mỗi lần lặp tạo một chuỗi mới; hãy dùng StringBuilder hoặc string.Join.