+= (opérateur Visual Basic)

  • Article

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

Syntaxe

variableorproperty += expression

Éléments

variableorproperty
Obligatoire. Toute variable ou propriété numérique ou String.

expression
Obligatoire. Toute expression numérique ou String.

Notes

L’élément situé à gauche de l’opérateur += peut être une variable scalaire simple, une propriété ou un élément d’un tableau. La variable ou la propriété ne peut pas être ReadOnly.

L’opérateur += ajoute la valeur à sa droite à la variable ou à la propriété à sa gauche et affecte le résultat à la variable ou à la propriété à sa gauche. L’opérateur += peut également être utilisé pour concaténer l’expression String à droite de la variable ou à la propriété String à sa gauche, et affecter le résultat à la variable ou à la propriété à sa gauche.

Notes

Lorsque vous utilisez l’opérateur +=, il se peut que vous ne puissiez pas déterminer si l’ajout ou la concaténation de chaînes se produira. Utilisez l’opérateur &= pour la concaténation afin d’éliminer toute ambiguïté et de fournir du code auto-documenté.

Cet opérateur d’affectation effectue implicitement des conversions étendues, mais pas restrictives, si l’environnement de compilation applique une sémantique stricte. Pour plus d’informations sur ces conversions, consultez Conversions d’élargissement et de réduction. Pour plus d’informations sur la sémantique stricte et permissive, consultez Instruction Option Strict.

Si la sémantique permissive est autorisée, l’opérateur += effectue implicitement une variété de chaînes et de conversions numériques identiques à celles effectuées par l’opérateur +. Pour plus d’informations sur ces conversions, consultez + Opérateur.

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 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 +, veillez à comprendre son comportement une fois qu’il est redéfini. Pour plus d'informations, consultez Operator Procedures.

Exemple

L’exemple suivant utilise l’opérateur += pour combiner la valeur d’une variable avec une autre. La première partie utilise += avec des variables numériques pour ajouter une valeur à une autre. La deuxième partie utilise += avec String des variables pour concaténer une valeur avec une autre. Dans les deux cas, le résultat est affecté à 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 désormais 13, et la valeur de str1 est maintenant « 103 ».

Voir aussi