+= (opérateur Visual Basic)

Mise à jour : novembre 2007

Ajoute la valeur d'une expression numérique à la valeur d'une variable ou propriété numérique et assigne le résultat à la variable ou propriété. Peut également être utilisé pour concaténer une expression String à une variable ou une propriété String et assigner le résultat à la variable ou propriété.

variableorproperty += expression

Éléments

  • variableorproperty
    Requis. Toute variable ou propriété numérique ou String.

  • expression
    Requis. Toute expression numérique ou String.

Notes

L'élément situé à gauche de l'opérateur += peut être une simple variable scalaire, une propriété ou un élément d'un tableau. La variable ou la propriété ne peut pas être ReadOnly (Visual Basic). L'opérateur += assigne la valeur du côté droit à la variable ou propriété du côté gauche.

Cet opérateur d'assignation effectue implicitement des conversions étendues, mais pas restrictives, si l'environnement de compilation applique des sémantiques strictes. Pour plus d'informations sur ces conversions, consultez Conversions étendues et restrictives. Pour plus d'informations sur les sémantiques strictes et permissives, consultez Option Strict, instruction.

Si les sémantiques permissives sont autorisées, l'opérateur += exécute implicitement un ensemble de conversions de chaînes et de conversions numériques identiques à celles exécutées par l'opérateur +. Pour plus d'informations sur ces conversions, consultez +, opérateur (Visual Basic).

Remarque :

Si vous utilisez l'opérateur += il vous sera parfois difficile de déterminer si une addition ou une concaténation de chaînes se produira. Utilisez l'opérateur &= pour la concaténation afin d'éliminer toute ambiguïté et de fournir un code auto-documenté.

Surcharge

L'opérateur + peut être surchargé, ce qui signifie qu'une classe ou une structure peut redéfinir son comportement lorsqu'un opérande a le type de cette classe ou de cette structure. La surcharge de l'opérateur + affecte le comportement de l'opérateur +=. Si votre code utilise += sur une classe ou structure qui surcharge +, assurez-vous que vous comprenez son comportement redéfini. Pour plus d'informations, consultez Procédures d'opérateur.

Exemple

L'exemple suivant utilise l'opérateur += pour combiner la valeur d'une variable à une autre. La première partie utilise += avec des variables numériques pour ajouter une valeur à une autre. La seconde partie utilise += avec des variables String pour concaténer une valeur à une autre. Dans les deux cas, le résultat est assigné à la première variable.

' 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

La valeur de num1 est maintenant 13 et la valeur de str1 est maintenant "103".

Voir aussi

Concepts

Instructions d'assignation

Référence

+, opérateur (Visual Basic)

Opérateurs d'assignation

Opérateurs arithmétiques (Visual Basic)

Opérateurs de concaténation (Visual Basic)

Priorité des opérateurs en Visual Basic

Opérateurs répertoriés par fonctionnalité