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