Comment : définir plusieurs versions d'une procédure

Article
09/12/2008

Mise à jour : novembre 2007

Vous pouvez définir une procédure dans plusieurs versions en la surchargeant, à l'aide du même nom, mais avec une liste de paramètres différente pour chaque version. La finalité d'une surcharge est de définir plusieurs versions de procédures étroitement liées sans avoir à les différencier par nom.

Pour plus d'informations, consultez Surcharge de procédure.

Pour définir plusieurs versions d'une procédure

Écrivez une instruction de déclaration Sub ou Function pour chaque version de la procédure que vous souhaitez définir. Utilisez le même nom de procédure dans chaque déclaration.
Précédez le mot clé Sub ou Function dans chaque déclaration du mot clé Overloads. Vous pouvez omettre Overloads dans les déclarations, mais si vous l'incluez dans une des déclarations, vous devez l'inclure dans toutes les déclarations.
À la suite de chaque instruction de déclaration, écrivez le code de procédure pour gérer le cas spécifique où le code appelant fournit des arguments qui correspondent à la liste de paramètres de cette version. Vous ne devez pas tester pour quels paramètres le code appelant a fourni les paramètres. Visual Basic passe le contrôle à la version correspondante de votre procédure.
Terminez chaque version de la procédure avec l'instruction End Sub ou End Function selon le cas.

Exemple

L'exemple suivant définit une procédure Sub pour publier une transaction par rapport au compte d'un client. Il utilise le mot clé Overloads pour définir deux versions de la procédure, un qui accepte le client par son nom et l'autre par son numéro de compte.

Overloads Sub post(ByVal custName As String, ByVal amount As Single)
    ' Insert code to access customer record by customer name.
End Sub
Overloads Sub post(ByVal custAcct As Integer, ByVal amount As Single)
    ' Insert code to access customer record by account number.
End Sub

Le code appelant peut obtenir l'identification de client en tant que String ou en tant que Integer, puis utiliser la même instruction appelante dans les deux cas.

Pour plus d'informations sur l'appel de ces versions de la procédure post, consultez Comment : appeler une procédure surchargée.