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órios. Qualquer variável ou propriedade numérica ou String.
expression
Obrigatórios. Qualquer expressão numérica ou String.
Comentários
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 à direita à variável ou propriedade à esquerda e atribui o resultado à variável ou à propriedade à esquerda. O operador += também pode ser usado para concatenar a expressão String à direita para a variável ou propriedade String à esquerda e atribuir o resultado à variável ou propriedade à esquerda.
Observação
Ao usar o operador +=, talvez você não consiga 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 autodocumentação.
Esse operador de atribuição executa implicitamente a ampliação, mas não limita as conversões se o ambiente de compilação impuser semântica estrita. Para obter mais informações, consulte Ampliando e restringindo conversões. Para obter mais informações sobre semântica estrita e permissiva, consulte Instrução estrita de opções.
Se a semântica permissiva for permitida, o operador += executará implicitamente uma variedade de conversões numéricas e de cadeia de caracteres idênticas às executadas pelo operador +. Para obter detalhes sobre essas conversões, consulte + Operador.
Sobrecarga
O operador + pode ser sobrecarregado, o que significa que uma classe ou estrutura pode redefinir seu comportamento quando um operando tem o tipo dessa classe ou estrutura. Sobrecarregar o operador + afeta o comportamento do operador +=. Se o seu código usa += em uma classe ou estrutura que sobrecarrega +, certifique-se de entender o comportamento redefinido. Para obter mais informações, confira Procedimentos de 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. Nos dois 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
Agora, o valor de num1 é 13, e o valor de str1 é "103".
