Operador + (Visual Basic)

  • Artigo

Adiciona dois números ou retorna o valor positivo de uma expressão numérica. Também pode ser usado para concatenar duas expressões de cadeia de caracteres.

Sintaxe

expression1 + expression2

ou

+expression1

Partes

Termo Definição
expression1 Obrigatórios. Qualquer expressão numérica ou de cadeia de caracteres.
expression2 Obrigatório, a menos que o operador + esteja calculando um valor negativo. Qualquer expressão numérica ou de cadeia de caracteres.

Result

Se expression1 e expression2 forem numéricos, o resultado será a soma aritmética.

Se expression2 estiver ausente, o operador + será o operador de identidade unário para o valor inalterado de uma expressão. Nesse sentido, a operação consiste em reter o sinal de expression1, portanto, o resultado será negativo se expression1 for negativo.

Se expression1 e expression2 forem cadeias de caracteres, o resultado será a concatenação dos valores.

Se expression1 e expression2 forem de tipos mistos, a ação executada dependerá dos tipos, do conteúdo e da configuração da Instrução Option Strict. Para obter mais informações, confira as tabelas em "Comentários".

Tipos com suporte

Todos os tipos numéricos, incluindo os de ponto flutuante e sem sinal, Decimal e String.

Comentários

Em geral, + executa a adição aritmética quando possível e concatena somente quando as duas expressões são cadeias de caracteres.

Se nenhuma das expressões for uma Object, o Visual Basic executará as ações a seguir.

Tipos de dados de expressões Ação por compilador
As duas expressões são tipos de dados numéricos (SByte, Byte, Short, UShort, Integer, UInteger, Long, ULong, Decimal, Single ou Double) Adicionar. O tipo de dados do resultado será um tipo numérico apropriado para os tipos de dados de expression1 e expression2. Consulte as tabelas "Aritmética de inteiros" nos Tipos de dados de resultados do operador.
As duas expressões são do tipo String Concatenate.
Uma expressão é um tipo de dados numérico e a outra é uma cadeia de caracteres Se Option Strict for On, gere um erro do compilador.

Se Option Strict for Off, converta implicitamente o String em Double e adicione.

Se não for possível converter o String em Double, gere uma exceção InvalidCastException.
Uma expressão é um tipo de dados numérico e a outra é Nothing Adicionar, com Nothing com valor de zero.
Uma expressão é uma cadeia de caracteres, e a outra é Nothing Concatenar, com Nothing com valor de "".

Se uma expressão for Object, o Visual Basic executará as ações a seguir.

Tipos de dados de expressões Ação por compilador
A expressão Object contém um valor numérico e a outra é um tipo de dados numérico Se Option Strict for On, gere um erro do compilador.

Se Option Strict for Off, adicione.
A expressão Object contém um valor numérico e a outra é do tipo String Se Option Strict for On, gere um erro do compilador.

Se Option Strict for Off, converta implicitamente o String em Double e adicione.

Se não for possível converter o String em Double, gere uma exceção InvalidCastException.
A expressão Object contém uma cadeia de caracteres e a outra é um tipo de dados numérico Se Option Strict for On, gere um erro do compilador.

Se Option Strict for Off, converta implicitamente a cadeia de caracteres Object em Double e adicione.

Se não for possível converter a cadeia de caracteres Object em Double, gere uma exceção InvalidCastException.
A expressão Object contém uma cadeia de caracteres e a outra é do tipo String Se Option Strict for On, gere um erro do compilador.

Se Option Strict for Off, converta implicitamente Object em String e concatene.

Se as duas expressões forem Object, o Visual Basic executará as ações a seguir (somente Option Strict Off).

Tipos de dados de expressões Ação por compilador
As duas expressões Object contêm valores numéricos Adicionar.
As duas expressões Object são d o tipo String Concatenate.
Uma expressão Object contém um valor numérico e a outra contém uma cadeia de caracteres Converta implicitamente a cadeia de caracteres Object em Double e adicione.

Se não for possível converter a cadeia de caracteres Object em um valor numérico, gere uma exceção InvalidCastException.

Se uma das expressões Object for avaliada como Nothing ou DBNull, o operador + a tratará como um String com valor de "".

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.

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. Se o código usar esse operador em uma classe ou estrutura, certifique-se de entender seu comportamento redefinido. Para obter mais informações, confira Procedimentos de operador.

Exemplo

O exemplo a seguir usa o operador + para adicionar números. Se os operandos forem numéricos, o Visual Basic calculará o resultado aritmético. O resultado aritmético representa a soma dos dois operandos.

Dim sumNumber As Integer
sumNumber = 2 + 2
sumNumber = 4257.04 + 98112
' The preceding statements set sumNumber to 4 and 102369.

Você também pode usar o operador + para concatenar cadeias de caracteres. Se os operandos forem cadeias de caracteres, o Visual Basic os concatenará. O resultado da concatenação representa uma única cadeia de caracteres que consiste no conteúdo dos dois operandos um após o outro.

Se os operandos forem de tipos mistos, o resultado dependerá da configuração da Instrução Option Strict. O exemplo a seguir ilustra o resultado quando Option Strict for On.

Option Strict On

Dim var1 As String = "34"
Dim var2 As Integer = 6
Dim concatenatedNumber As Integer = var1 + var2

' The preceding statement generates a COMPILER ERROR.

O exemplo a seguir ilustra o resultado quando Option Strict for Off.

Option Strict Off

Dim var1 As String = "34"
Dim var2 As Integer = 6
Dim concatenatedNumber As Integer = var1 + var2

' The preceding statement returns 40 after the string in var1 is
' converted to a numeric value. This might be an unexpected result.
' We do not recommend use of Option Strict Off for these operations.

Para eliminar a ambiguidade, você deve usar o operador & em vez de + para concatenação.

Confira também