Partager via

+=, opérateur (Visual Basic)

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

Syntaxe

variableorproperty += expression

Pièces

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

expression
Obligatoire. Toute expression ou String numérique.

Remarques

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 à droite à la variable ou à la propriété à gauche et affecte le résultat à la variable ou à la propriété à gauche. L’opérateur += peut également être utilisé pour concaténer l’expression String à droite de la variable ou de la String propriété à gauche, et affecter le résultat à la variable ou à la propriété à gauche.

Remarque

Lorsque vous utilisez l’opérateur += , vous ne pourrez peut-être pas déterminer si l’ajout ou la concaténation de chaîne se produit. Utilisez l’opérateur &= pour la concaténation pour éliminer l’ambiguïté et fournir du code auto-documentant.

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

Si la sémantique permissive est autorisée, l’opérateur += effectue implicitement une variété de conversions de chaînes et 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 une structure qui surcharge +, veillez à comprendre 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 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 est num1 maintenant 13, et la valeur est str1 maintenant « 103 ».

Voir aussi