Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C#

Interpolacja ciągów znaków

Interpolacja wstawia wyniki wyrażeń bezpośrednio do tekstu przy użyciu składni $"...". Obsługuje formatowanie wartości, wyrównanie i dosłowne klamry; przy przewidywalnym formatowaniu liczb należy jawnie wybrać kulturę.

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

Składnia

$"text {expression[,width][:formatString]}"

W zwykłym interpolowanym literale ciągu znaków $"..." znak $ musi znajdować się bezpośrednio przed cudzysłowem otwierającym. C# dopuszcza również interpolowany literał dosłowny $@"...", w którym znak @ oddziela $ od cudzysłowu otwierającego. Wyrażenia w {} dostarczają wartości wstawianych do wynikowego tekstu. Bez prefiksu $ klamry pozostają zwykłym tekstem. Wartość null daje pusty tekst.

Element ma postać {expression[,width][:formatString]}; nawiasy kwadratowe oznaczają części opcjonalne. Stała całkowita width określa minimalną szerokość: dodatnia wyrównuje do prawej, ujemna do lewej, bez obcinania dłuższych wartości. :F2 formatuje liczbę z dwiema cyframi po separatorze dziesiętnym. Format musi być obsługiwany przez typ wartości.

W zwykłym interpolowanym literale zapisz {{ i }}, aby uzyskać dosłowne klamry. Zwykłe sekwencje ucieczki, takie jak \n, nadal działają. Wyrażenie warunkowe ?: umieść w nawiasach okrągłych, ponieważ : rozpoczyna format.

Domyślne formatowanie zależy od CultureInfo.CurrentCulture. Przykład używa string.Create z CultureInfo.InvariantCulture, aby separator dziesiętny i wynik były przewidywalne. Łączy dosłowne klamry, interpolację name oraz wyrównanie i formatowanie price.

Przykłady

using System;
using System.Globalization;

string name = "Ada";
decimal price = 12.5m;
string message = string.Create(
    CultureInfo.InvariantCulture,
    $"{{{name}}}: |{price,7:F2}|");
Console.WriteLine(message);

Wynik

{Ada}: |  12.50|

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła