C# String Interpolation ve String.Format: Biçim Belirteçleri, Hizalama, Kültür

String interpolation, literal metinden ve ifadelerden bir string oluşturur. Literal'in önüne $ koyun, herhangi bir C# ifadesini süslü parantez içine yazın; değeri metne çevrilip yerleştirilir:

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

Çıktı:

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

Interpolation C# 6 ile geldi. Derleyici onu bir string.Format ya da string.Concat çağrısına (C# 10'dan beri daha verimli handler koduna) çevirir, bu yüzden string'i elle oluşturmaktan daha yavaş değildir.

Son satırdaki koşullu ifade parantez gerektirir. Bir interpolation boşluğunun içinde iki nokta bir biçim belirtecini başlatır, bu yüzden parantezsiz {x > 10 ? "yes" : "no"} bir derleme hatasıdır.

Biçim belirteçleri

İfadeden sonra iki nokta ve bir biçim string'i değerin nasıl yazılacağını kontrol eder. Aynı biçim string'leri ToString("...") ve string.Format ile de çalışır.

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

Çıktı:

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

Standart kodlar; her birinin ardından isteğe bağlı bir hassasiyet sayısı gelebilir:

Özel desenler yer tutuculardan bir biçim oluşturur: 0 her zaman gösterilen bir basamaktır, # yalnızca anlamlıysa gösterilen bir basamaktır, . ondalık noktadır, sayının içindeki , grup ayırıcılarını açar ve % 100 ile çarpar. "0.##" en fazla iki ondalık gösterir ve sondaki sıfırları atar; "#,##0.00" klasik muhasebe biçimidir.

Tüm sayısal biçimlendirme gösterilen değeri yuvarlar; değişkenin kendisi değişmez. Bir değer tam ortadayken (2.25'in tek ondalıkla gösterilmesi), farklı çalışma zamanları ve tipler eşitliği farklı yuvarlayabilir; kural önemliyse önce Math.Round(value, 1, MidpointRounding.AwayFromZero) ile açıkça yuvarlayın, sonra biçimlendirin.

Interpolation'da tarihler

DateTime değerleri tarih biçim string'lerini aynı şekilde alır:

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

Çıktı:

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

Bir TimeSpan özel biçimi, literal karakterlerin ters eğik çizgiyle kaçırılmasını gerektirir; bu, normal bir string literal'inde \\: olarak yazılır. Tarih kodlarının tam listesi (yyyy, MM, HH, tt...) ve onlarla yapılan hatalar (mm dakika, MM aydır) DateTime format sayfasındadır.

Hizalama ve doldurma

İfadeden sonraki bir virgül en küçük alan genişliğini belirler. Pozitif bir sayı sağa, negatif bir sayı sola hizalar. Bir biçimle birleştiğinde düz metinde tabloları hizalar:

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

Çıktı:

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

Sözdizimi {expression,alignment:format} şeklindedir: önce hizalama, sonra biçim. Genişlikten uzun bir değer kırpılmaz; satırın geri kalanını iter. PadLeft ve PadRight, interpolation dışında aynı doldurmayı yapar.

Süslü parantezleri kaçırmak

Literal bir süslü parantez yazdırmak için onu ikiye katlayın: {{ ve }}. Çıktı JSON, CSS ya da kod olduğunda bu gerekir:

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

Çıktı:

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

JSON'u böyle elle oluşturmak hızlı bir log satırı için sorun değildir; gerçek JSON için name içindeki tırnakları ve özel karakterleri doğru ele alan bir serializer kullanın.

string.Format ve bileşik biçimlendirme

C# 6'dan önce biçimlendirme, numaralı yer tutucular ve bir argüman listesi alan string.Format ile yapılırdı. Aynı bileşik biçim sözdizimini Console.WriteLine, StringBuilder.AppendFormat ve TextWriter.Write de kabul eder:

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

Çıktı:

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

Kodda interpolation'ı tercih edin: değerler göründükleri yerde durur, bu yüzden bir yer tutucu yanlış argümanı gösteremez. Şablon veri olduğunda, örneğin bir kaynak dosyasından yüklenen çevrilmiş bir mesajda, doğru araç hâlâ string.Format'tır. Eşleşen argümanı olmayan bir yer tutucu indeksi (iki argümanla {2}) çalışma zamanında bir FormatException fırlatır.

Kültür: ayırıcıları ve para birimini kontrol etmek

Interpolation, ToString ve string.Format varsayılan olarak thread'in geçerli kültürünü kullanır. Almancaya ayarlı bir makinede {1234.5:N2} 1.234,50 üretir; ABD'de 1,234.50 üretir. C para birimi biçimi kültürün sembolünü kullanır. Kültürü açıkça seçmek için interpolated string'i bir FormattableString olarak yakalayın ve bir sağlayıcıyla biçimlendirin:

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

Çıktı:

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

İnsanların okuduğu metin için kullanıcının kültürünü, başka bir programın okuduğu her şey için CultureInfo.InvariantCulture'ı kullanın. Almanca bir makinede geçerli kültürle yazılmış bir CSV'de sayıların içinde virgüller olur ve başka yerde okunamaz. .NET 6 ve sonrasında string.Create(CultureInfo.InvariantCulture, $"..."), ara nesne olmadan FormattableString.Invariant ile aynı işi yapar.

Verbatim ve ham interpolated string'ler

$, verbatim interpolated string için @ ile birleşir: ters eğik çizgiler olduğu gibi kalır ve string satırlara yayılabilir. C# 8 ve sonrası iki sırayı da kabul eder ($@ ya da @$); C# 6 ve 7 $@ ister:

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

Çıktı:

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

C# 11 ham interpolated string'leri ekledi. Tek $ ile süslü parantezler her zamanki gibi ifadeleri işaretler. $$ ile tek süslü parantez olduğu gibi kalır ve ifadeler iki süslü parantez ister; bu da JSON ve kod şablonlarını okunur kılar:

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

C# 11 ayrıca bir interpolation boşluğunun içinde satır sonlarına izin verir, böylece uzun bir ifade ya da bir switch ifadesi birkaç satıra bölünebilir.

Yaygın hatalar

• $'ı unutmak. "Total: {total}" süslü parantezleri olduğu gibi yazdırır. Derleyici uyarmaz.
• Süslü parantezler içinde parantezsiz bir ternary: iki nokta bir biçim ayırıcısı olarak okunur.
• Makinenin okuyacağı çıktıyı geçerli kültürle biçimlendirmek. Ondalık virgüller CSV'yi, JSON'u ve SQL'i bozar. Invariant kültürü kullanın.
• Para için biçimsiz ToString() kullanmak. 2.5m, 2.50 değil 2.5 olarak yazdırılır. F2, N2 ya da C kullanın.
• Bir döngüde interpolation ile büyük string'ler oluşturmak. Her yineleme yeni bir string yaratır; StringBuilder ya da string.Join kullanın.