Como: Quebrar e combinar instruções no código (Visual Basic)

  • Artigo

Ao escrever seu código, às vezes você pode criar instruções longas que exigem rolagem horizontal no Editor de Códigos. Embora isso não afete a maneira como seu código é executado, torna difícil para você ou qualquer outra pessoa ler o código como ele aparece no monitor. Nesses casos, você deve considerar dividir a única instrução longa em várias linhas.

Para dividir uma única instrução em várias linhas

Use o caractere de continuação de linha, que é um sublinhado (_), no ponto em que você deseja que a linha seja quebrada. O sublinhado deve ser imediatamente precedido por um espaço e imediatamente seguido por um terminador de linha (retorno de carro) ou (a partir da versão 16.0) um comentário seguido de um retorno de carro.

Nota

Em alguns casos, se você omitir o caractere de continuação de linha, o compilador do Visual Basic continuará implicitamente a instrução na próxima linha de código. Para obter uma lista de elementos de sintaxe para os quais você pode omitir o caractere de continuação de linha, consulte "Continuação de linha implícita" em Instruções.

No exemplo a seguir, a instrução é dividida em quatro linhas com caracteres de continuação de linha terminando todas, exceto a última linha.

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

A utilização desta sequência torna o seu código mais fácil de ler, tanto online como quando impresso.

O caractere de continuação de linha deve ser o último caractere em uma linha. Você não pode segui-lo com mais nada na mesma linha.

Existem algumas limitações sobre onde você pode usar o caractere de continuação de linha; por exemplo, você não pode usá-lo no meio de um nome de argumento. Você pode quebrar uma lista de argumentos com o caractere de continuação de linha, mas os nomes individuais dos argumentos devem permanecer intactos.

Não é possível continuar um comentário usando um caractere de continuação de linha. O compilador não examina os caracteres em um comentário para um significado especial. Para um comentário de várias linhas, repita o símbolo de comentário (') em cada linha.

Embora colocar cada instrução em uma linha separada é o método recomendado, Visual Basic também permite que você coloque várias instruções na mesma linha.

Para colocar várias instruções na mesma linha

Separe as instruções com dois pontos (:), como no exemplo a seguir:

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

Consulte também