Operadores de adição – +
e +=
Os operadores +
e +=
são compatíveis com os tipos numéricos internos integrais e ponto flutuante, o tipo cadeia de caracteres e os tipos delegados.
Para obter informações sobre o operador +
aritmético, consulte as seções Operadores de adição e subtração unários e Operador de adição + do artigo Operadores aritméticos.
Concatenação de cadeia de caracteres
Quando um ou ambos os operandos forem do tipo cadeia de caracteres, o operador +
concatenará as representações de cadeia de caracteres de seus operandos (a representação de cadeia de caracteres de null
é uma cadeia de caracteres vazia):
Console.WriteLine("Forgot" + "white space");
Console.WriteLine("Probably the oldest constant: " + Math.PI);
Console.WriteLine(null + "Nothing to add.");
// Output:
// Forgotwhite space
// Probably the oldest constant: 3.14159265358979
// Nothing to add.
A interpolação de cadeia de caracteres oferece uma maneira mais conveniente de formatar cadeias de caracteres:
Console.WriteLine($"Probably the oldest constant: {Math.PI:F2}");
// Output:
// Probably the oldest constant: 3.14
A partir do C# 10, você pode usar a interpolação de cadeia de caracteres para inicializar uma cadeia de caracteres constante quando todas as expressões usadas para espaços reservados também são cadeias de caracteres constantes.
A partir do C# 11, o operador +
executa a concatenação de cadeia de caracteres para cadeias de caracteres literais UTF-8. Esse operador concatena dois objetos ReadOnlySpan<byte>
.
Combinação de delegados
Para operandos do mesmo tipo delegado, o operador +
retorna uma nova instância de delegado que, quando invocada, chama o operando esquerdo e, em seguida, chama o operando direito. Se qualquer um dos operandos for null
, o operador +
retornará o valor de outro operando (que também pode ser null
). O exemplo a seguir mostra como os delegados podem ser combinados com o operador +
:
Action a = () => Console.Write("a");
Action b = () => Console.Write("b");
Action ab = a + b;
ab(); // output: ab
Para executar a remoção de delegado, use o operador -
.
Para obter mais informações sobre tipos de delegado, veja Delegados.
Operador de atribuição de adição +=
Uma expressão que usa o operador +=
, como
x += y
é equivalente a
x = x + y
exceto que x
é avaliado apenas uma vez.
O exemplo a seguir demonstra o uso do operador +=
:
int i = 5;
i += 9;
Console.WriteLine(i);
// Output: 14
string story = "Start. ";
story += "End.";
Console.WriteLine(story);
// Output: Start. End.
Action printer = () => Console.Write("a");
printer(); // output: a
Console.WriteLine();
printer += () => Console.Write("b");
printer(); // output: ab
Você também usará o operador +=
para especificar um método de manipulador de eventos ao assinar um evento. Para obter mais informações, confira Como assinar e cancelar a assinatura de eventos.
Capacidade de sobrecarga do operador
Um tipo definido pelo usuário pode sobrecarregar o operador +
. Quando um operador +
binário é sobrecarregado, o operador +=
também é implicitamente sobrecarregado. Um tipo definido pelo usuário não pode sobrecarregar explicitamente o operador +=
.
Especificação da linguagem C#
Para obter mais informações, veja as seções Operador de adição unário e Operador de adição da Especificação de linguagem C#.