Comment : diviser et combiner des instructions dans le code (Visual Basic)

Lorsque vous écrivez votre code, vous pouvez être amené à créer de longues instructions qui vous imposent un défilement horizontal dans l'éditeur de code. Même si cela n'affecte en rien l'exécution de votre code, cela en complique la lecture à l'écran, pour vous comme pour toute autre personne. Il est donc fortement recommandé de répartir cette instruction longue sur plusieurs lignes.

À l'inverse, vous pouvez être amené à consolider des instructions sur une seule ligne, notamment lorsque vous avez plusieurs instructions très courtes et que vous souhaitez garder de la place pour la suite. Cette fonctionnalité peut également être utile lorsqu'il s'agit d'organiser des variables ou des commandes dans un module.

Pour couper une même instruction en plusieurs lignes

  • À l'endroit auquel vous voulez couper la ligne, utilisez le caractère de continuation de ligne, qui est un trait de soulignement (_). Le trait de soulignement doit être immédiatement précédé d'un espace ou d'une marque de fin de ligne (retour chariot). Dans certains cas, vous pouvez omettre le caractère de continuation de ligne et le compilateur Visual Basic continuera implicitement l'instruction sur la ligne de code suivante. Pour obtenir une liste des éléments syntaxiques pour lesquels le caractère de continuation de ligne peut être omis, consultez « Continuation de ligne implicite » dans Instructions dans Visual Basic.

    Dans l'exemple ci-dessous, l'instruction est répartie sur quatre lignes à l'aide de caractères de continuation terminant toutes les lignes à l'exception de la dernière.

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

    L'utilisation de cette séquence simplifie la lecture de votre code, tant à l'écran que sur papier.

    Notes

    Le caractère de continuation de ligne est nécessairement le dernier élément d'une ligne. Vous ne pouvez la faire suivre d'aucun autre élément sur cette même ligne.

    Il existe certaines restrictions relatives à l'emplacement du caractère de continuation de ligne ; ainsi, il est impossible de l'utiliser au milieu d'un nom d'argument. Vous pouvez couper une liste d'arguments à l'aide du caractère de continuation de ligne, mais les noms respectifs des arguments doivent rester intacts.

    Notes

    Vous ne pouvez pas continuer un commentaire à l'aide d'un caractère de continuation de ligne. Une fois le commentaire commencé, le compilateur n'examine plus les caractères pour y rechercher une signification particulière. Dans le cas d'un commentaire à répartir sur plusieurs lignes, répétez le symbole de commentaire (') sur chaque ligne.

Même si la méthode recommandée consiste à placer chaque instruction sur une ligne séparée, Visual Basic vous permet de placer plusieurs instructions sur une même ligne.

Pour placer plusieurs instructions sur une même ligne

  • Séparez les instructions par un caractère deux-points (:), comme dans l'exemple suivant.

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

Voir aussi

Autres ressources

Structure de programme et conventions de codage (Visual Basic)

Instructions dans Visual Basic