Fazendo anotações em seus programas: Usando comentários

  • Artigo

Nesta lição, você aprenderá como criar os comentários no código de seus programas.

O código que constitui um programa pode ser difícil de ler e compreender, especialmente se você não for a pessoa que originalmente o escreveu.Usando comentários, você pode criar anotações para si mesmo ou para outros usuários do seu código.

Os comentários são entradas de texto no Editor de Códigos ignoradas pelo compilador do Visual Basic quando o programa é executado.Assim, você pode escrever uma anotação para si mesmo que explica o que faz uma seção específica do seu programa, ou que lembra você para concluir tarefas de programação não concluídas.

Para criar um comentário começando uma linha com o caractere '.O exemplo a seguir demonstra como criar um comentário.

' This is a comment. WOW!

Você pode adicionar comentários nas extremidades das linhas, também usando o caractere '.Isso é feito com frequência para fornecer comentários sobre linhas individuais de código, como visto no exemplo a seguir.

MsgBox("Hello World!") ' This line causes a message box to appear.

Como com comentários de uma linha, tudo após o caractere ' nessa linha é ignorado pelo programa.

Usando comentários para depuração

Outro uso comum de comentários é impedir temporariamente que uma linha de código seja executada enquanto você depura seu programa.Por exemplo, suponha que você tivesse uma linha de código que exibisse uma caixa de mensagem.

MsgBox("Hello World!")

Se você quisesse executar o programa sem exibi-la, mas não desejasse excluí-la permanentemente, você poderia usar o caractere de comentário (') para temporariamente ocultá-la do seu programa, como mostrado abaixo.

' MsgBox("Hello World!")

Como tudo após o caractere ' é ignorado, o programa será executado sem executar esta linha.Mais tarde você pode remover o caractere ' e a caixa de mensagem será exibida.

Tente-o!

Para inserir comentários

  1. No menu File, escolha NewProject.

  2. No painel Templates, na caixa de diálogo New Project, clique em Windows Application.

  3. Na caixa Name digite Commentse clique em OK.

    Abre um novo projeto Windows Forms.

  4. Clique duas vezes no formulário para abrir o Editor de Código.

  5. No manipulador de eventos Form1_Load, digite o código a seguir.

    ' This code will cause two message boxes to appear
MsgBox("This is Message Box 1") ' Display Message Box 1
MsgBox("This is Message Box 2") ' Display Message Box 2

  6. Pressione F5 para executar a página.

    O programa é iniciado e cada uma das duas caixas de mensagem são mostradas por vez.

  7. No menu Debug, escolha Stop Debugging para encerrar o programa.

  8. No Editor de Códigos, adicione um caractere de comentário (') à linha da primeira caixa de mensagem, da seguinte maneira.

    ' MsgBox("This is MessageBox 1") ' Ignore Message Box 1

  9. Pressione F5 para executar a página.

    Observe que dessa vez, a primeira linha da caixa de mensagem é ignorada pelo programa, e somente a segunda caixa de mensagem é mostrada.

Próximas etapas

Nesta lição, você aprendeu a usar comentários para criar anotações no seu código e para desativar temporariamente linhas individuais de código.Isso conclui as lições sobre depuração.No próximo conjunto de lições, você aprenderá a usar um banco de dados para armazenar e recuperar informações do seu programa.

Próxima Lesson: Gerenciando seus registros: usando dados em seu programa

Consulte também

Conceitos

Comentários no código

Outros recursos

O que deu errado? Localizando e corrigindo erros por meio de depuração