Compartilhar via


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

Ao escrever seu código, você pode criar instruções longas que exigem rolagem horizontal no Editor de Código. Embora isso não afete a maneira como seu código é executado, isso dificulta que você ou qualquer outra pessoa leia 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 quebre. O sublinhado deve ser imediatamente precedido por um espaço e imediatamente seguido por um terminador de linha (código de fim de linha) ou (começando com a versão 16.0) um comentário seguido por um código de fim de linha.

Observação

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 encerrando todas, exceto a última linha.

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

O uso dessa sequência facilita a leitura do código, tanto online como 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.

Você não pode continuar um comentário usando um caractere de continuação de linha. O compilador não examina os caracteres em um comentário para obter 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 seja o método recomendado, o 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

Confira também