Comment : diviser et combiner des instructions dans le code

Mise à jour : novembre 2007

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 et immédiatement suivi d'une marque de fin de ligne (retour chariot).

  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.

  Remarque :
  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.

  Remarque :
  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 à ne faire figurer qu'une seule instruction par ligne, 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

Instructions dans Visual Basic