Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C#

Interpolace řetězců

Interpolace řetězců vkládá výsledky výrazů přímo do textu pomocí syntaxe $"...". Podporuje formátování a zarovnání hodnot i doslovné složené závorky; pokud má být formátování čísel předvídatelné, zvolte kulturu výslovně.

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

Syntaxe

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

V běžném interpolovaném řetězcovém literálu ve tvaru $"..." musí znak $ stát bezprostředně před počáteční uvozovkou. C# umožňuje také interpolovaný doslovný literál (verbatim) ve tvaru $@"...", v němž znak @ odděluje $ od počáteční uvozovky. Výrazy uvnitř {} poskytují hodnoty vkládané do výsledného textu. Bez předpony $ zůstávají složené závorky běžným textem. Hodnota null vytvoří prázdný text.

Interpolovaná položka má tvar {expression[,width][:formatString]}; hranaté závorky označují nepovinné části. Celočíselná konstanta width nastavuje minimální šířku: kladné hodnoty zarovnávají doprava, záporné doleva, aniž by se delší hodnoty zkracovaly. :F2 formátuje číslo na dvě desetinná místa. Typ hodnoty musí daný formát podporovat.

V běžném interpolovaném literálu zapište {{ a }}, chcete-li vytvořit doslovné složené závorky. Běžné escape sekvence, například \n, stále fungují. Podmíněný výraz používající ?: uzavřete do závorek, protože : uvádí formát.

Výchozí formátování závisí na CultureInfo.CurrentCulture. Příklad používá string.Create s CultureInfo.InvariantCulture, aby byly desetinný oddělovač a výstup předvídatelné. Kombinuje doslovné složené závorky, interpolaci name a zarovnání i formátování price.

Příklady

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

Výsledek

{Ada}: |  12.50|

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje