Comment : appeler une procédure qui accepte des paramètres optionnels
Mise à jour : novembre 2007
Lorsque vous appelez une procédure à l'aide d'un paramètre facultatif, vous pouvez choisir de fournir l'argument correspondant ou non. Dans le cas contraire, la procédure utilise la valeur par défaut déclarée pour ce paramètre.
Si vous avez l'intention de fournir l'argument, incluez-le normalement dans la liste d'arguments, entre virgules.
Si vous avez l'intention d'omettre l'argument, utilisez les virgules consécutives dans la liste d'arguments pour marquer son omission.
Si vous omettez l'argument et vous fournissez des arguments par nom, vous ne devez pas indiquer l'argument omis que ce soit par nom ou par virgules.
Exemple
L'exemple suivant fait plusieurs appels à la fonction MsgBox. MsgBox a un paramètre requis et deux paramètres facultatifs.
MsgBox("Important message", MsgBoxStyle.Critical, "MsgBox Example")
MsgBox("Just display this message.")
MsgBox("Test message", , "Title bar text")
MsgBox(Title:="Title bar text", Prompt:="Test message")
Le premier appel à MsgBox fournit les trois arguments dans l'ordre. MsgBox les définit. Le deuxième appel fournit uniquement l'argument requis. Le troisième et le quatrième appel fournissent le premier et le troisième argument. Le troisième appel le fait par position et le quatrième appel le fait par nom.
Compilation du code
Avant d'omettre un argument dans la liste d'arguments, assurez-vous que le paramètre correspondant est facultatif, assurez-vous également que vous souhaitez que la procédure utilise la valeur par défaut pour ce paramètre.
Si vous fournissez un argument par nom, assurez-vous que le nom dans la liste d'arguments correspond exactement au nom de paramètre déclaré.
Voir aussi
Tâches
Comment : définir des paramètres optionnels pour une procédure
Comment : déterminer si un paramètre optionnel a été fourni
Concepts
Paramètres et arguments d'une procédure
Passage d'arguments par valeur et par référence
Passage des arguments par position et par nom