Interpolação, Verbatim String Literals, Múltiplas Linhas – Tudo Sobre Strings no C#

A linguagem C# faz o tratamento de strings levando em consideração Escape Codes, que são códigos precedidos pelo caracter “\”. Desta forma temos que:

string temp = "C:\\Windows";
// Conteúdo de temp:
C:\Windows

string temp = "Fernão \"Capelo\" Gaivota\u0066";
// Conteúdo de temp:
Fernão "Capelo" Gaivota!

string temp = "Rio de Janeiro\nBrasil";
// Conteúdo de temp:
Rio de Janeiro
Brasil

string temp = "C:\\Windows";

// Conteúdo de temp:

C:\Windows

​

string temp = "Fernão \"Capelo\" Gaivota\u0066";

// Conteúdo de temp:

Fernão "Capelo" Gaivota!

​

string temp = "Rio de Janeiro\nBrasil";

// Conteúdo de temp:

Rio de Janeiro

Brasil

Se quisermos inserir um texto com múltiplas linhas em uma variável, temos que recorrer a um recurso como:

string temp = "SELECT Nome, Endereco, Telefone " +
    "FROM Cadastro " +
    "WHERE Id = 10 ";
// Conteúdo de temp:
SELECT Nome, Endereco, Telefone FROM Cadastro WHERE Id = 10

xxxxxxxxxx

string temp = "SELECT Nome, Endereco, Telefone " +

    "FROM Cadastro " +

    "WHERE Id = 10 ";

// Conteúdo de temp:

SELECT Nome, Endereco, Telefone FROM Cadastro WHERE Id = 10

Observe que, apesar de escrita em três linhas, foi gerada uma string concatenada com uma única linha. Para que a variável armazene o texto em múltiplas linhas teria que se colocar “\n” nos pontos onde se deseja fazer as quebras.

Alguns escape codes mais comuns:

\' = '
\" = "
\\ = \
\n = New Line (chr(13)+chr(10))
\t = Tab
\u = Unicode Character UTF-16 (exemplo: \u00e7 = ç)
\U = Unicode Character UTF-32 (exemplo: \U0001F47D = "")
\x = Mesmo que \u com tamanho variável (exemplo: \x00E7 or \x0E7 or \xE7 = "ç")
\b = Backspace
\0 = Null
\a = Alert
\e = Escape
\f = Form Feed
\r = Carriage Return (chr(13))
\v = Vertical Tab

Mas é possível escrever strings literais em C#, que não seguem a metodologia de escape codes e vamos abordar todas as formas neste artigo.

Então agora vamos aprender como manipular strings no C# de forma mais eficiente:

Comentários

Vamos começar pelo mais básico, como escrever comentários dentro de um código C#.

• Linhas de comentário são precedidas por duas barras “//”.
• Se o comentário tiver múltiplas linhas, inicie com “/*” e termine com “*/”.
• É possível também utilizar “/*” e “*/” para inserir um comentário no meio do código.

// Comentário com uma única linha

/* Comentário com
múltimplas linhas */

int a = 10;
int b = 20;
int c = 30; // Comentário no final da linha
string rem = a.toString() + /*comentário no meio da linha */ " " + b.toString();

/// Documentação XML

xxxxxxxxxx

// Comentário com uma única linha

​

/* Comentário com

múltimplas linhas */

​

int a = 10;

int b = 20;

int c = 30; // Comentário no final da linha

string rem = a.toString() + /*comentário no meio da linha */ " " + b.toString();

​

/// Documentação XML

Eu falo um pouco mais sobre documentação XML neste artigo.

Interpolação

Interpolação é o recurso que nos permite inserir tokens no meio da string que serão substituídos em tempo de execução:

• A string deve ser precedida por “$”.
• As variáveis que serão interpoladas devem estar {entre chaves}.
• As conversões dos tipos para string acontecem de forma implícita.

// Preparando ambiente
string Nome = "Kelly";
string Idade = 40;
DateTime Agora = DateTime.Now;

// Sem interpolação:
string temp = "Nome: " + Nome + 
    "Idade: "+ Idade.toString() + "anos. " + 
    "Enviado às " + Agora.Hour.toString + ":" + Agora.Minute.toString() + " horas.";

// Com interpolação:
string temp = $"Nome: {Nome}, Idade: {Idade} anos. Enviado às {Agora:HH:mm} Horas.";

// Conteúdo de temp em ambos os casos:
Nome: Kelly, Idade: 40, Enviado às 12:35 Horas.

xxxxxxxxxx

// Preparando ambiente

string Nome = "Kelly";

string Idade = 40;

DateTime Agora = DateTime.Now;

​

// Sem interpolação:

string temp = "Nome: " + Nome + 

    "Idade: "+ Idade.toString() + "anos. " + 

    "Enviado às " + Agora.Hour.toString + ":" + Agora.Minute.toString() + " horas.";

​

// Com interpolação:

string temp = $"Nome: {Nome}, Idade: {Idade} anos. Enviado às {Agora:HH:mm} Horas.";

​

// Conteúdo de temp em ambos os casos:

Nome: Kelly, Idade: 40, Enviado às 12:35 Horas.

Para caracterizar que vai utilizar interpolação a string deve iniciar com “$”. Não pode haver espaço entre $ e as aspas. As variáveis ficam entre chaves, conforme exemplo da linha 12 acima:

string temp = $"Nome: {Nome}, Idade: {Idade} anos. Enviado às {Agora:HH:mm} Horas.";

Sintaxe:
{<ExpressãoDeInterpolação>[,<Alinhamento>][:<Formato>]}

• ExpressãoDeInterpolação: Expressão que produz o resultado a ser formatado. Quando nulo retorna string vazia.
• Alinhamento: Inteiro que representa a quantidade mínima de caracteres deve ter o resultado. Quando positivo, alinha pela direita, quando negativo alinha pela esquerda.
• Formato: Formatação que será aplicada. Para detalhes, veja este artigo em Microsoft Learn.

Operações utilizando strings interpoladas:

string strLeft = "Esquerda";
string strRight = "Direita";
string temp = $"|{strLeft,-10}|{strRight,10}|";
// Conteúdo de temp:
// |Esquerda  |   Direita|

string temp = $"{Math.Pi:F3}";
// Conteúdo de temp:
// 3.142

int Nota = 50;
string Nome = "Isaac";
string temp = $"A nota de {Nome} está classificada como {
  Nota switch 
  {
      > 90 => "Excelente",
      > 70 => "Boa",
      > 50 => "Média",
      _ => "Ruim",
  }
  }.";
// Conteúdo de temp:
// A nota de Isaac está classificada como Média.

string temp = $"{Nome} foi {
    (Nota >= 50
     ? "Aprovado"
     : "Reprovado")
     }.";
// Conteúdo de temp:
// Isaac foi Aprovado.

    
int Idade = 30;
string temp = $"{Nome} tem {Idade} ano{(Idade == 1 ? "" : "s")} de idade.";
// Conteúdo de temp:
// Isaac tem 30 anos de idade.

double VelocidadeDaLuz = 299792.458;
System.Globalization.CultureInfo.CurrentCulture = System.Globalization.CultureInfo.GetCultureInfo("pt-BR");
string temp = $"A velocidade da luz é {VelocidadeDaLuz:N3} km/s.";
// Conteúdo de temp:
// A velocidade da luz é 299.792,458 km/s.

var CulturaEspecifica = System.Globalization.CultureInfo.GetCultureInfo("en-IN");
string temp = string.Create(CulturaEspecifica, $"A velocidade da luz é {VelocidadeDaLuz:N3} km/s.");
// Conteúdo de temp:
// A velocidade da luz é 2,99,792.458 km/s.

string temp = string.Create(System.Globalization.CultureInfo.InvariantCulture, $"A velocidade da luz é {VelocidadeDaLuz:N3} km/s.");
// Conteúdo de temp:
// A velocidade da luz é 299,792.458 km/s.

xxxxxxxxxx

string strLeft = "Esquerda";

string strRight = "Direita";

string temp = $"|{strLeft,-10}|{strRight,10}|";

// Conteúdo de temp:

// |Esquerda  |   Direita|

​

string temp = $"{Math.Pi:F3}";

// Conteúdo de temp:

// 3.142

​

int Nota = 50;

string Nome = "Isaac";

string temp = $"A nota de {Nome} está classificada como {

  Nota switch 

  {

      > 90 => "Excelente",

      > 70 => "Boa",

      > 50 => "Média",

      _ => "Ruim",

  }

  }.";

// Conteúdo de temp:

// A nota de Isaac está classificada como Média.

​

string temp = $"{Nome} foi {

    (Nota >= 50

     ? "Aprovado"

     : "Reprovado")

     }.";

// Conteúdo de temp:

// Isaac foi Aprovado.

​

int Idade = 30;

string temp = $"{Nome} tem {Idade} ano{(Idade == 1 ? "" : "s")} de idade.";

// Conteúdo de temp:

// Isaac tem 30 anos de idade.

​

double VelocidadeDaLuz = 299792.458;

System.Globalization.CultureInfo.CurrentCulture = System.Globalization.CultureInfo.GetCultureInfo("pt-BR");

string temp = $"A velocidade da luz é {VelocidadeDaLuz:N3} km/s.";

// Conteúdo de temp:

// A velocidade da luz é 299.792,458 km/s.

​

var CulturaEspecifica = System.Globalization.CultureInfo.GetCultureInfo("en-IN");

string temp = string.Create(CulturaEspecifica, $"A velocidade da luz é {VelocidadeDaLuz:N3} km/s.");

// Conteúdo de temp:

// A velocidade da luz é 2,99,792.458 km/s.

​

string temp = string.Create(System.Globalization.CultureInfo.InvariantCulture, $"A velocidade da luz é {VelocidadeDaLuz:N3} km/s.");

// Conteúdo de temp:

// A velocidade da luz é 299,792.458 km/s.

​

Se precisar escrever tokens {x} dentro de uma string interpolada, basta aumentar o número de $ no início da string. A quantidade de $ será o indicativo de quantas chaves são necessárias para caracterizar um token de de interpolação.

string nome = "Albert";
string temp = $"O seu nome é {nome}.";
// temp:
O seu nome é Albert.
  
string temp = $$"O seu nome é {nome}.";
// temp:
O seu nome é {nome}.
  
string temp = $$"O seu nome é {{nome}}.";
// temp:
O seu nome é Albert.

xxxxxxxxxx

string nome = "Albert";

string temp = $"O seu nome é {nome}.";

// temp:

O seu nome é Albert.

string temp = $$"O seu nome é {nome}.";

// temp:

O seu nome é {nome}.

string temp = $$"O seu nome é {{nome}}.";

// temp:

O seu nome é Albert.

Uma constante pode conter elementos interpolados, desde que esses elementos também sejam constantes:

constant Inventor = "Santos Dumont";
constant eterno = "Quem inventou o avião foi {Nome} e isso não se discute!";

xxxxxxxxxx

constant Inventor = "Santos Dumont";

constant eterno = "Quem inventou o avião foi {Nome} e isso não se discute!";

String Literals

Para escrever strings no C# sem levar em consideração os escape codes é necessário recorrer às string literals. Dessa forma é possível até mesmo escrever strings com múltiplas linhas de forma bem mais visualmente amigável. Existem dois tipos: Verbatim String Literals e Raw String Literals, sendo que a segunda possui mais recursos.

Verbatim String Literals

Uma Verbatim String Literal é caracterizada pelo @ no início da formação. Pode ser em qualquer ordem @” ou “@.
Exemplo mostrando a mesma string escrito da forma padrão e da forma Verbatim:

string temp1 = "C:\\Temp\\Aula1";
string temp2 = @"C:\Temp\Aula1";

// O conteúdo das duas strings é:
C:\Temp\Aula1

O único código especial dentro de uma Verbatim string é “, que deve ser representado como “”.

string temp = @"O nome do livro é ""João e Maria"".";

É possível também utilizar comandos do C# com o identificador Verbatim. No exemplo abaixo, vou criar um objeto com o nome for e outro com o nome if:

string[] @for = {"VW","Audi","Porsche"};
string @if = "Mercedes-Benz";

E ainda podemos utilizar um recurso interessante de interpolação utilizando o código acima, dessa forma:

string[] @for = {"VW","Audi","Porsche"};
for (int i = 0; i < @for.length; i++)
{
  Console.WriteLine($"Trabalhamos com {@for[i]}.");
}
// Resultado:
// Trabalhamos com VW.
// Trabalhamos com Audi.
// Trabalhamos com Porsche.

xxxxxxxxxx

string[] @for = {"VW","Audi","Porsche"};

for (int i = 0; i < @for.length; i++)

{

  Console.WriteLine($"Trabalhamos com {@for[i]}.");

}

// Resultado:

// Trabalhamos com VW.

// Trabalhamos com Audi.

// Trabalhamos com Porsche.

Usando Verbatim Literals para escrever uma string multi-linhas:

string cmdSQL = @"SELECT Nome, Endereco, Telefone
FROM Cadastro 
WHERE Id = 10";

int id = 10;
strint cmdSQL = $@"SELECT Nome, Endereco, Telefone
FROM Cadastro
WHERE Id = {id}";

xxxxxxxxxx

string cmdSQL = @"SELECT Nome, Endereco, Telefone

FROM Cadastro 

WHERE Id = 10";

​

int id = 10;

strint cmdSQL = $@"SELECT Nome, Endereco, Telefone

FROM Cadastro

WHERE Id = {id}";

Raw String Literals

É outra forma de escrever strings de forma literal, sem os escape codes, porém de uma forma ainda mais amigável que Verbatim String Literals. Uma Raw String Literal deve estar contida entre, no mínimo 3 aspas. Dessa forma:

string temp = """Isso é uma raw string que pode conter \ e "".";
// Resultado de temp:
Isso é uma raw string que pode conter \ e ".

Se precisar escrever aspas duplas ou triplas, basta aumentar o número de aspas que delimita a raw string, por exemplo:

string temp = """"Essa raw string tem "" em seu conteúdo."""";
// Resultado de temp:
Essa raw string tem "" em seu conteúdo.

Raw strings também podem ser combinadas com interpolação:

string Nome = "Nikola Tesla";
string temp = $"""O {Nome} foi um grande "gênio".""";
// Resultado de temp:
// O Nikola Tesla foi um grande "gênio".

xxxxxxxxxx

string Nome = "Nikola Tesla";

string temp = $"""O {Nome} foi um grande "gênio".""";

// Resultado de temp:

// O Nikola Tesla foi um grande "gênio".

Mas as raw strings se destacam mesmo na hora de escrever strings com múltiplas linhas porque, ao contrário das verbatim strings, que fazem uma bagunça com a identação, as raw strings fazem um belo controle deste recurso, por exemplo:

int id = 10;
string sqlCmd = $"""
  SELECT Nome, Endereco, Telefone
  FROM Cadastro
    INNER JOIN Profissoes
      ON Profissao = Profissoes
  WHERE Id = {id}
  """;

xxxxxxxxxx

int id = 10;

string sqlCmd = $"""

  SELECT Nome, Endereco, Telefone

  FROM Cadastro

    INNER JOIN Profissoes

      ON Profissao = Profissoes

  WHERE Id = {id}

  """;

Vai gerar o seguinte resultado em sqlCmd:

ATENÇÃO: Este exemplo é apenas para fins didáticos. Nunca utilize concatenação ou interpolação de strings para escrever uma SQL Query. Isso irá deixá-la extremamente suscetível a um tipo de ataque chamado SQL Injection.

SELECT Nome, Endereco, Telefone
FROM Cadastro
  INNER JOIN Profissoes
    ON Profissao = Profissoes
WHERE Id = 10

xxxxxxxxxx

SELECT Nome, Endereco, Telefone

FROM Cadastro

  INNER JOIN Profissoes

    ON Profissao = Profissoes

WHERE Id = 10

Observe que:

• A primeira e a última quebra de linha foram suprimidas, mantendo apenas o conteúdo contido entre os delimitadores da raw string.
• Os espaços de identação também foram suprimidos, mantendo a identação apenas no código, para melhor organização porém eliminando-a no resultado final.
• A string começa e termina com quebras de linha.
• Espaços em branco após as aspas de abertura, na primeira linha são ignorados.
• Linhas vazias no conteúdo da raw strings são respeitadas.
• Se as aspas de fechamento não estiverem seguindo o padrão de identação, a string será interpretada como uma verbatim string.

Se achou este conteúdo relevante, considere assinar este blog preenchendo seu e-mail abaixo, ou deixando um comentários lá no final.