Tutorial: Saiba como usar o editor de código com o Visual Basic

Neste tutorial, você experimentará o editor de código no Visual Studio. Você adicionará código a um arquivo para aprender algumas das maneiras pelas quais o Visual Studio facilita a escrita, a navegação e a compreensão do código do Visual Basic.

Este artigo pressupõe que você já esteja familiarizado com o Visual Basic. Se não estiver, convém começar com um tutorial como Criar um aplicativo de console simples do Visual Basic (VB).

Para concluir este tutorial, verifique se você tem as configurações do Visual Basic selecionadas para o Visual Studio. Para obter informações sobre como selecionar configurações para o IDE (ambiente de desenvolvimento integrado), consulte Selecionar configurações de ambiente.

Se você ainda não instalou o Visual Studio, acesse a página downloads do Visual Studio para instalá-lo gratuitamente.

Criar um arquivo de código

Comece criando um arquivo e adicionando algum código a ele.

  1. Abra o Visual Studio. Pressione Esc ou selecione Continuar sem código na janela de início para abrir o ambiente de desenvolvimento.

  2. No menu Arquivo na barra de menus, selecione Novo Arquivo.

  3. Na caixa de diálogo Novo Arquivo, na categoria Geral, selecione Classe do Visual Basice, em seguida, selecione Abrir.

    Um novo arquivo é aberto no editor com o esqueleto de uma classe do Visual Basic. (Você já pode notar que não precisa criar um projeto completo do Visual Studio para obter alguns dos benefícios que o editor de código fornece, como realce de sintaxe. Tudo o que você precisa é de um arquivo de código.)

    Captura de tela de um novo arquivo de classe do Visual Basic no editor de código do Visual Studio.

  1. Abra o Visual Studio. Pressione Esc ou selecione Continuar sem código na janela inicial para abrir o ambiente de desenvolvimento.

  2. No menu Arquivo na barra de menus, selecione Novo Arquivo.

  3. Na caixa de diálogo Novo Arquivo, na categoria Geral, selecione Classe de Visual Basice, em seguida, selecione Abrir.

    Um novo arquivo é aberto no editor com o esqueleto de uma classe do Visual Basic. (Você já pode notar que não precisa criar um projeto completo do Visual Studio para obter alguns dos benefícios que o editor de código fornece, como realce de sintaxe. Tudo o que você precisa é de um arquivo de código.)

    Captura de tela de um novo arquivo de classe do Visual Basic no editor de código do Visual Studio.

Usar snippets de código

O Visual Studio fornece snippets de código que você pode usar para gerar os blocos de código usados com frequência de forma rápida e fácil. Trechos de código estão disponíveis para várias linguagens de programação, incluindo Visual Basic, C# e C++. Agora você adicionará o snippet de código Sub do Visual Basic ao arquivo.

  1. Coloque o cursor acima da linha que diz End Classe digite sub-.

    Uma caixa de diálogo pop-up é exibida com informações sobre a palavra-chave Sub e como inserir o snippet de código Sub.

    Captura de tela do IntelliSense para um snippet de código 'Sub' no Visual Studio.

  2. Pressione Tab duas vezes para inserir o snippet de código.

    O esboço do procedimento Sub MySub() é adicionado ao arquivo.

Os snippets de código disponíveis variam para diferentes linguagens de programação. Examine os snippets de código disponíveis para o Visual Basic selecionando Editar>IntelliSense>Inserir Snippet (ou pressione Ctrl+K, Ctrl+X). Para o Visual Basic, os snippets de código estão disponíveis para as seguintes categorias:

Captura de tela da janela Inserir Snippet com uma lista de pastas de categoria que contêm snippets de código do Visual Basic.

Há snippets para determinar se existe um arquivo no computador, fazer uma gravação em um arquivo de texto, ler um valor de registro, executar uma consulta SQL ou criar uma instrução For Each...Next, entre outros.

  1. Coloque o cursor acima da linha que diz End Classe digite sub-.

    Uma janela pop-up é exibida com informações sobre a palavra-chave Sub e como inserir o snippet de código Sub.

    Captura de tela do IntelliSense para um snippet de código 'Sub' no Visual Studio.

  2. Selecione Aba duas vezes para inserir o trecho de código.

    O esboço do procedimento Sub MySub() é adicionado ao arquivo.

Os snippets de código disponíveis variam para diferentes linguagens de programação. Você pode ver os snippets de código disponíveis para o Visual Basic clicando com o botão direito do mouse no editor de código e selecionando Inserir Snippet> (ou pressionando Ctrl+K, Ctrl+X). Para o Visual Basic, os snippets de código estão disponíveis para as seguintes categorias:

Captura de tela mostrando a janela Inserir Snippet com uma lista de pastas de categoria que contêm snippets de código do Visual Basic.

Comentar o código

Nesta seção, você comentará algum código.

Captura de tela da barra de ferramentas no Visual Studio, que inclui botões para adicionar e remover comentários de código.

  1. Cole o código abaixo no corpo do procedimento MySub().

    ' _words is a string array that we'll sort alphabetically
    Dim _words = New String() {
    "the",
    "quick",
    "brown",
    "fox",
    "jumps"
    }
    
    Dim morewords = New String() {
    "over",
    "the",
    "lazy",
    "dog"
    }
    
    Dim query = From word In _words
                Order By word.Length
                Select word
    
  2. Digamos que você não esteja usando a matriz morewords, mas poderá usá-la mais tarde, portanto, não deseja excluí-la. Em vez disso, você pode comentar essas linhas. Selecione a definição inteira de morewords até a chave de fechamento e, em seguida, selecione o botão Comentar as linhas selecionadas na barra de ferramentas. Se preferir usar o teclado, selecione Ctrl+K, Ctrl+C.

    Captura de tela da barra de ferramentas. O botão para comentar o código é realçado em vermelho.

    O caractere de comentário do Visual Basic ' é adicionado ao início de cada linha selecionada para comentar o código.

Captura de tela da barra de ferramentas no Visual Studio, que inclui botões para adicionar e remover comentários de código.

  1. Cole o código a seguir no corpo do procedimento MySub().

    ' _words is a string array that we'll sort alphabetically
    Dim _words = New String() {
    "the",
    "quick",
    "brown",
    "fox",
    "jumps"
    }
    
    Dim morewords = New String() {
    "over",
    "the",
    "lazy",
    "dog"
    }
    
    Dim query = From word In _words
                Order By word.Length
                Select word
    
  2. Digamos que você não esteja usando a matriz morewords, mas poderá usá-la mais tarde, portanto, não deseja excluí-la. Em vez disso, você pode comentar essas linhas. Selecione a definição inteira de morewords até a chave de fechamento e, em seguida, selecione o botão Comentar as linhas selecionadas na barra de ferramentas. Se preferir usar o teclado, selecione Ctrl+K, Ctrl+C.

    Captura de tela da barra de ferramentas. O botão para comentar o código é realçado em vermelho.

    O caractere de comentário do Visual Basic ' é adicionado ao início de cada linha selecionada para comentar o código.

Recolher blocos de código

Você pode ocultar seções de código para se concentrar apenas nas partes do seu interesse. Para praticar, tente reduzir a matriz _words a uma linha em código. Selecione a caixa pequena com o sinal de menos dentro dela na margem da linha que diz Dim _words = New String() {. Ou, se você for um usuário de teclado, coloque o cursor em qualquer lugar na definição da matriz e selecione Ctrl+M, Ctrl+M.

Captura de tela do editor de Visual Studio Code. O botão para recolher a estrutura de tópicos de uma seção de código está realçada em vermelho.

O bloco de código é recolhido apenas na primeira linha, seguido por um sinal de reticências (...). Para expandir o bloco de código, selecione a mesma caixa, que agora tem um sinal de adição ou selecione Ctrl+M, Ctrl+M novamente. Esse recurso é chamado de estrutura de tópicos e é especialmente útil quando você estiver recolhendo métodos longos ou classes inteiras.

Recolha seções de código para se concentrar apenas nas partes de seu interesse. Para praticar, tente reduzir o array _words a uma única linha de código. Selecione a seta para baixo na margem da linha que diz Dim _words = New String() {. Ou, se você for um usuário de teclado, coloque o cursor em qualquer lugar na definição da matriz e selecione Ctrl+M, Ctrl+M.

Captura de tela do editor de Visual Studio Code. O botão para recolher a estrutura de tópicos de uma seção de código está realçada em vermelho.

O bloco de código é recolhido apenas na primeira linha, seguido por um sinal de reticências (...). A seta para baixo na margem agora é uma seta que aponta para a direita. Para expandir o bloco de código, selecione a seta > ou pressione Ctrl+M, Ctrl+M novamente. Esse recurso é chamado de estrutura de tópicos e é especialmente útil quando você estiver recolhendo métodos longos ou classes inteiras.

Exibir definições de símbolo

O editor do Visual Studio facilita a inspeção da definição de um tipo ou membro de classe. Você pode fazer isso navegando até o arquivo que contém a definição, por exemplo, clicando com o botão direito do mouse e selecionando Ir para Definição em qualquer lugar em que o símbolo for referenciado. Uma maneira ainda mais rápida que não afasta seu foco do arquivo em que você está trabalhando é usar Peek Definition. Agora você vai espiar a definição do tipo String.

  1. Clique com o botão direito do mouse na palavra String e selecione Espiar Definição. Ou pressione Alt+F12.

    Uma janela pop-up que contém a definição da classe String é exibida. Você pode rolar na janela pop-up ou até mesmo inspecionar a definição de outro tipo do código inspecionado.

    Captura de tela de uma janela pop-up Espiar Definição que contém a definição da classe Cadeia de Caracteres.

  2. Feche a janela Espiar Definição selecionando o botão Fechar no canto superior direito da janela pop-up.

O editor do Visual Studio facilita a inspeção da definição de um tipo ou membro de classe. Você pode fazer isso navegando até o arquivo que contém a definição, por exemplo, clicando com o botão direito do mouse e selecionando Ir para Definição em qualquer lugar em que o símbolo for referenciado. Uma maneira ainda mais rápida que não move o foco para fora do arquivo em que você está trabalhando é usar a opção Inspecionar Definição. Agora você dará uma olhada na definição do tipo String.

  1. Clique com o botão direito do mouse na palavra String e selecione Espiar Definição. Ou pressione Alt+F12.

    Uma janela pop-up que contém a definição da classe String é exibida. Você pode rolar na janela pop-up ou até mesmo inspecionar a definição de outro tipo do código inspecionado.

    Captura de tela de uma janela pop-up Espiar Definição que contém a definição da classe Cadeia de Caracteres.

  2. Feche a janela Espiar Definição selecionando o botão Fechar no canto superior direito da janela pop-up.

Usar o IntelliSense para concluir palavras

IntelliSense é um recurso valioso quando você está programando. Ele pode mostrar informações sobre membros disponíveis de um tipo ou detalhes de parâmetros para sobrecargas diferentes de um método. Você também pode usar o IntelliSense para concluir uma palavra depois de digitar caracteres suficientes para desambiguar. Agora você adicionará uma linha de código para imprimir as cadeias de caracteres ordenadas na janela do console, que é o local padrão para a saída de um programa.

  1. Abaixo da variável query, comece a digitar o seguinte código:

    For Each str In qu
    

    Você verá o IntelliSense mostrar as Informações Rápidas sobre o símbolo query.

    Captura de tela da janela de conclusão de palavras do IntelliSense para a palavra

  2. Para inserir o restante da palavra query usando a funcionalidade de preenchimento de palavras do IntelliSense, pressione Tab.

  3. Finalize o bloco de código para que ele se pareça com o seguinte código.

    For Each str In query
        Console.WriteLine(str)
    Next
    

IntelliSense é um recurso valioso quando você está programando. Ele pode mostrar informações sobre os membros disponíveis de uma classe, ou detalhes dos parâmetros de diferentes sobrecargas de um método. Você também pode usar o IntelliSense para concluir uma palavra depois de digitar caracteres suficientes para desambiguar. Agora você vai adicionar uma linha de código para imprimir as cadeias de caracteres ordenadas na janela de console, que é o local padrão para envio da saída do programa.

  1. Abaixo da variável query, comece a digitar o seguinte código:

    For Each str In qu
    

    O IntelliSense mostra informações rápidas sobre o símbolo de query.

    Captura de tela da janela de conclusão de palavras do IntelliSense para a palavra

  2. Para inserir o restante da palavra query usando a funcionalidade de preenchimento de palavras do IntelliSense, selecione Tab.

  3. Finalize o bloco de código para que ele se assemelhe ao código a seguir.

    For Each str In query
        Console.WriteLine(str)
    Next
    

Refatorar um nome

Ninguém acerta o código na primeira vez e uma das coisas que você pode ter que alterar é o nome de uma variável ou método. Agora você tentará a funcionalidade de refatoração do Visual Studio para renomear a variável _words para words.

  1. Clique com o botão direito do mouse na definição da variável _words e selecione Renomear.

    A janela Renomear será exibida no canto superior direito do editor.

  2. Com a variável _words ainda selecionada, digite o nome desejado: palavras. Observe que a referência a words na consulta é renomeada automaticamente. Antes de pressionar Enter ou selecionar Aplicar, marque a caixa de seleção Incluir comentários na janela Renomear.

    Captura de tela da janela Renomear para a variável '_words'. A caixa de seleção Incluir comentários está selecionada.

  3. Pressione Enter ou selecione Aplicar.

    Ambas as ocorrências de words são renomeadas, além da referência a words no comentário de código.

Ninguém acerta o código na primeira vez e uma das coisas que você pode ter que alterar é o nome de uma variável ou método. Agora você tentará a funcionalidade de refatoração do Visual Studio para renomear a variável _words para words.

  1. Clique com o botão direito do mouse na definição da variável _words e selecione Renomear.

    Uma janela de renomeação é exibida.

  2. Com a variável _words ainda selecionada, insira o nome desejado: palavras. Observe que a referência a words na consulta é renomeada automaticamente. Antes de selecionar Enter, selecione a caixa de seleção Incluir comentários na janela Renomear.

    Captura de tela da janela Renomear. A caixa de seleção 'Incluir comentários' está selecionada.

  3. Selecione Inserir.

    Ambas as ocorrências de words são renomeadas, além da referência a words no comentário de código.

Próxima etapa