WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C#

String-Interpolation

Bei der String-Interpolation werden Ergebnisse von Ausdrücken mit der Syntax $"..." direkt in Text eingefügt. Sie unterstützt Formatierung, Ausrichtung und wörtliche geschweifte Klammern; wenn Zahlen vorhersehbar formatiert werden müssen, sollte eine Kultur explizit gewählt werden.

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

Syntax

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

Bei einem regulären interpolierten Zeichenfolgenliteral der Form $"..." muss $ unmittelbar vor dem öffnenden Anführungszeichen stehen. C# erlaubt auch die interpolierte Verbatim-Form $@"...", bei der @ zwischen $ und dem öffnenden Anführungszeichen steht. Ausdrücke innerhalb von {} liefern Werte, die in den resultierenden Text eingefügt werden. Ohne das Präfix $ bleiben geschweifte Klammern normaler Text. Ein Wert von null ergibt leeren Text.

Ein Interpolationselement hat die Form {expression[,width][:formatString]}; eckige Klammern kennzeichnen optionale Teile. Die ganzzahlige Konstante width legt eine Mindestbreite fest: Positive Werte richten rechtsbündig, negative linksbündig aus, ohne längere Werte abzuschneiden. :F2 formatiert eine Zahl mit zwei Nachkommastellen. Der Typ des Werts muss das Format unterstützen.

Schreibe in einem regulären interpolierten Literal {{ und }}, um wörtliche geschweifte Klammern auszugeben. Gewöhnliche Escape-Sequenzen wie \n funktionieren weiterhin. Setze einen bedingten Ausdruck mit ?: in Klammern, da : ein Format einleitet.

Die Standardformatierung hängt von CultureInfo.CurrentCulture ab. Das Beispiel verwendet string.Create mit CultureInfo.InvariantCulture, damit Dezimaltrennzeichen und Ausgabe vorhersehbar sind. Es kombiniert wörtliche geschweifte Klammern, die Interpolation von name sowie Ausrichtung und Formatierung von price.

Beispiele

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

Ergebnis

{Ada}: |  12.50|

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen