Passage d'arguments par valeur et par référence

Article
09/12/2008

Mise à jour : novembre 2007

En Visual Basic, vous pouvez passer un argument à une procédure par valeur ou par référence. Cette opération est appelée mécanisme de passage et détermine si la procédure peut modifier l'élément de programmation sous-jacent à l'argument dans le code appelant. La déclaration de procédure détermine le mécanisme de passage pour chaque paramètre en spécifiant le mot clé ByVal ou ByRef.

Distinctions

Lorsque vous passez un argument à une procédure, informez-vous des diverses distinctions qui ont une interaction entre elles :

L'élément de programmation sous-jacent est-il modifiable ou non modifiable ?
L'argument lui-même est-il modifiable ou non modifiable ?
L'argument est-il passé par valeur ou par référence ?
Le type de données d'argument est-il un type valeur ou un type référence ?

Pour plus d'informations, consultez Différences entre les arguments modifiables et non modifiables et Différences entre le passage d'un argument par valeur et par référence.

Choix du mécanisme de passage

Vous devez choisir avec soin le mécanisme de passage pour chaque argument.

Protection. Lors du choix d'un mécanisme de passage, le critère le plus important est la fréquence à laquelle les variables d'appel doivent changer. Le passage d'un argument par ByRef permet à la procédure de retourner une valeur au code appelant via cet argument. Le passage d'un argument par ByVal permet d'empêcher une variable d'être modifiée par la procédure.
Performances. Bien que le mécanisme de passage puisse affecter les performances de votre code, la différence est généralement insignifiante. La seule exception à cette règle est le passage d'un type valeur par ByVal. Dans ce cas, Visual Basic copie tout le contenu des données de l'argument. Par conséquent, dans le cas d'un type valeur de grande taille tel qu'une structure, il peut être préférable d'effectuer un passage ByRef.

Pour les types référence, seul le pointeur vers les données est copié (quatre octets sur les plateformes 32 bits, huit octets sur les plateformes 64 bits). Par conséquent, vous pouvez passer des arguments de type String ou Object par valeur sans nuire aux performances.

Détermination du mécanisme de passage

La déclaration de procédure spécifie le mécanisme de passage pour chaque paramètre. Le code appelant ne peut pas substituer un mécanisme ByVal, mais si un argument est déclaré à l'aide de ByRef, le code appelant peut forcer le mécanisme à effectuer un passage ByVal en mettant le nom de l'argument entre parenthèses dans l'appel.

Le comportement par défaut en Visual Basic consiste à passer les arguments par valeur. Vous pouvez faciliter la lecture de votre code en utilisant le mot clé ByVal. En programmation, il est conseillé d'ajouter le mot clé ByVal ou ByRef à chaque paramètre déclaré.

Quand passer un argument par valeur

Si l'élément de code appelant sous-jacent à l'argument est un élément non modifiable, déclarez le paramètre ByVal correspondant. Aucun code ne peut modifier la valeur d'un élément non modifiable.
Si l'élément sous-jacent est modifiable, et si vous ne souhaitez pas que la procédure puisse modifier sa valeur, déclarez le paramètre ByVal. Seul le code appelant peut modifier la valeur d'un élément modifiable passée par valeur.

Quand passer un argument par référence

Si la procédure nécessite véritablement que l'élément sous-jacent dans le code appelant soit modifié, déclarez le paramètre ByRef correspondant.
Si l'exécution correcte du code dépend de la procédure modifiant l'élément sous-jacent dans le code appelant, déclarez le paramètre ByRef. Si vous le passez par valeur ou si le code appelant substitue le mécanisme de passage ByRef en mettant l'argument entre parenthèses, l'appel de procédure peut produire des résultats inattendus.