Procédure : diviser et combiner des instructions dans le code (Visual Basic)

Lors de l’écriture de votre code, vous pouvez parfois créer de longues instructions qui nécessitent un défilement horizontal dans l’éditeur de code. Bien que cela n’affecte pas la façon dont votre code s’exécute, il est difficile pour vous ou quelqu’un d’autre de lire le code tel qu’il apparaît sur le moniteur. Dans ce cas, vous devez envisager de diviser l’instruction longue unique en plusieurs lignes.

Pour diviser une instruction unique en plusieurs lignes

Utilisez le caractère de continuation de ligne, qui est un trait de soulignement (_), au point auquel vous souhaitez que la ligne s’arrête. Le trait de soulignement doit être immédiatement précédé d’un espace et immédiatement suivi d’un point de terminaison de ligne (retour chariot) ou (à compter de la version 16.0) d’un commentaire suivi d’un retour chariot.

Notes

Dans certains cas, si vous omettez le caractère de continuation de ligne, le compilateur Visual Basic continue implicitement l’instruction sur la ligne de code suivante. Pour obtenir la liste des éléments de syntaxe pour lesquels vous pouvez omettre le caractère de continuation de ligne, consultez « Continuation de ligne implicite » dans Instructions.

Dans l’exemple suivant, l’instruction est divisée en quatre lignes avec des caractères de continuation de ligne terminant toutes les lignes, sauf la dernière ligne.

cmd.CommandText = _
    "SELECT * FROM Titles JOIN Publishers " _
    & "ON Publishers.PubId = Titles.PubID " _
    & "WHERE Publishers.State = 'CA'"

L’utilisation de cette séquence facilite la lecture de votre code, à la fois en ligne et lors de l’impression.

Le caractère de continuation de ligne doit être le dernier caractère d’une ligne. Vous ne pouvez pas le suivre avec quoi que ce soit d’autre sur la même ligne.

Certaines limitations existent quant à l’emplacement où vous pouvez utiliser le caractère de continuation de ligne ; par exemple, vous ne pouvez pas l’utiliser au milieu d’un nom d’argument. Vous pouvez interrompre une liste d’arguments avec le caractère de continuation de ligne, mais les noms individuels des arguments doivent rester intacts.

Vous ne pouvez pas continuer un commentaire à l’aide d’un caractère de continuation de ligne. Le compilateur n’examine pas les caractères d’un commentaire à la recherche d’une signification particulière. Pour une commentaire de ligne multiple, répétez le symbole de commentaire (') sur chaque ligne.

Bien que le placement de chaque instruction sur une ligne distincte soit la méthode recommandée, Visual Basic vous permet également de placer plusieurs instructions sur la même ligne.

Pour placer plusieurs instructions sur la même ligne

Séparez les instructions par un signe deux-points (:), comme dans l’exemple suivant :

text1.Text = "Hello" : text1.BackColor = System.Drawing.Color.Red

Voir aussi