Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C#

Interpolação de cadeias de caracteres

A interpolação de cadeias de caracteres insere diretamente no texto os resultados de expressões, usando a sintaxe $"...". Suporta formatação e alinhamento de valores, bem como chavetas literais; escolha explicitamente uma cultura quando a formatação numérica tiver de ser previsível.

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

Sintaxe

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

Num literal de cadeia interpolada normal, da forma $"...", $ tem de preceder imediatamente as aspas de abertura. C# também aceita a forma interpolada verbatim $@"...", em que @ separa $ das aspas de abertura. As expressões entre {} fornecem os valores inseridos no texto resultante. Sem o prefixo $, as chavetas são texto normal. Um valor null produz texto vazio.

Um elemento de interpolação tem a forma {expression[,width][:formatString]}; os parênteses retos indicam partes opcionais. A constante inteira width define uma largura mínima: valores positivos alinham à direita e valores negativos à esquerda, sem truncar valores mais longos. :F2 formata um número com duas casas decimais. O tipo do valor tem de suportar o formato.

Num literal interpolado normal, escreva {{ e }} para produzir chavetas literais. As sequências de escape habituais, como \n, continuam a funcionar. Coloque entre parênteses uma expressão condicional que use ?:, porque : introduz um formato.

A formatação predefinida depende de CultureInfo.CurrentCulture. O exemplo usa string.Create com CultureInfo.InvariantCulture para tornar previsíveis o separador decimal e o resultado. Combina chavetas literais, a interpolação de name e o alinhamento e a formatação de price.

Exemplos

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

Resultado

{Ada}: |  12.50|

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes