^=, opérateur (Visual Basic)

Déclenche la valeur d’une variable ou d’une propriété à la puissance d’une expression et affecte le résultat à la variable ou à la propriété.

Syntaxe

variableorproperty ^= expression  

Éléments

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

expression
Obligatoire. Toute expression numérique.

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 ^= déclenche d’abord la valeur de la variable ou de la propriété (sur le côté gauche de l’opérateur) à la puissance de la valeur de l’expression (sur le côté droit de l’opérateur). L’opérateur affecte ensuite le résultat de cette opération à la variable ou à la propriété.

Visual Basic effectue toujours une élévation à une puissance dans le type de données Double. Les opérandes de tout type différent sont convertis en Double, et le résultat est toujours Double.

La valeur de expression peut être fractionnaire, négative ou les deux.

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 élever la valeur d’une variable Integer à la puissance d’une deuxième variable et affecter le résultat à la première variable.

Dim var1 As Integer = 10
Dim var2 As Integer = 3
var1 ^= var2
' The value of var1 is now 1000.

Voir aussi