+= Operador (Visual Basic)
Adiciona o valor de uma expressão numérica ao valor de uma variável numérica ou propriedade e atribui o resultado à variável ou propriedade. Também pode ser usado para concatenar uma String expressão a uma String variável ou propriedade e atribuir o resultado à variável ou propriedade.
Sintaxe
variableorproperty += expression
Partes
variableorproperty
Obrigatório. Qualquer número, String variável ou propriedade.
expression
Obrigatório. Qualquer número ou String expressão.
Observações
O elemento no lado esquerdo do += operador pode ser uma variável escalar simples, uma propriedade ou um elemento de uma matriz. A variável ou propriedade não pode ser ReadOnly.
O += operador adiciona o valor à sua direita à variável ou propriedade à sua esquerda e atribui o resultado à variável ou propriedade à sua esquerda. O += operador também pode ser usado para concatenar a String expressão à sua direita para a String variável ou propriedade à sua esquerda, e atribuir o resultado à variável ou propriedade à sua esquerda.
Nota
Ao usar o += operador, talvez não seja possível determinar se a concatenação de adição ou cadeia de caracteres ocorrerá. Use o operador para concatenação para eliminar a &= ambiguidade e fornecer código de auto-documentação.
Este operador de atribuição executa implicitamente a ampliação, mas não a redução de conversões, se o ambiente de compilação impuser semântica estrita. Para obter mais informações sobre essas conversões, consulte Ampliando e restringindo conversões. Para obter mais informações sobre semântica estrita e permissiva, consulte Declaração estrita de opção.
Se a semântica permissiva for permitida, o += operador executa implicitamente uma variedade de conversões numéricas e de cadeia de caracteres idênticas às realizadas pelo + operador. Para obter detalhes sobre essas conversões, consulte + Operador.
Sobrecarga
O + operador pode estar sobrecarregado, o que significa que uma classe ou estrutura pode redefinir seu comportamento quando um operando tem o tipo dessa classe ou estrutura. A sobrecarga do + operador afeta o comportamento do += operador. Se o seu código usa += em uma classe ou estrutura que sobrecarrega +, certifique-se de entender seu comportamento redefinido. Para obter mais informações, consulte Procedimentos do operador.
Exemplo
O exemplo a seguir usa o += operador para combinar o valor de uma variável com outra. A primeira parte usa += com variáveis numéricas para adicionar um valor a outro. A segunda parte usa += com String variáveis para concatenar um valor com outro. Em ambos os casos, o resultado é atribuído à primeira variável.
' This part uses numeric variables.
Dim num1 As Integer = 10
Dim num2 As Integer = 3
num1 += num2
' This part uses string variables.
Dim str1 As String = "10"
Dim str2 As String = "3"
str1 += str2
O valor de num1 agora é 13, e o valor de str1 é agora "103".
