ExpertiDict

C# · Essencial · Inglês · Técnico

string interpolation

/strɪŋ ɪnˌtɝpəˈleɪʃən/substantivo

Texto prefixado com $ que embute expressões entre chaves, com formato opcional após dois-pontos; o compilador a converte em uma construção eficiente de string.

Onde usar

Substitui concatenações longas e string.Format em quase todo código novo, e aceita alinhamento e formatos como {preco:C2}. Em logs, porém, prefira templates com placeholders.

Em código

var nome = "Ana";
decimal preco = 19.9m;
Console.WriteLine($"Oi, {nome}!");
Console.WriteLine($"Total: {preco:C2}");
Console.WriteLine($"[{nome,-6}]{preco,8:F1}");

Exemplos

Just use string interpolation instead of Format.

Use interpolação de string em vez de Format.

Add :C2 inside the braces to format it as currency.

Adicione :C2 dentro das chaves para formatar como moeda.

Cuidado

Não use em mensagens de ILogger nem para montar SQL com dados do usuário em ADO.NET puro: atrapalha logs estruturados e abre espaço para injeção.

Sinônimos

interpolated string

Antônimos

concatenação

Veja também

Todos os termos de C#