Saiba como usar o editor de códigos com Visual Basic

Nesta introdução de 10 minutos ao editor de código do Visual Studio, adicionaremos o código a um arquivo para ver algumas das formas pelas quais o Visual Studio facilita a escrita, a navegação e o entendimento do código do Visual Basic.

Dica

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

Este artigo pressupõe que você já esteja familiarizado com o Visual Basic. Se não estiver, sugerimos que consulte primeiro um tutorial como Criar um aplicativo de console Visual Basic (VB) simples.

Dica

Para acompanhar este artigo, 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), confira Selecionar configurações de ambiente.

Criar um novo arquivo de código

Comece criando um novo arquivo e adicionando códigos nele.

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

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

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

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

    Screenshot showing a new Visual Basic class file in the Visual Studio code editor.

  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, escolha Novo>Arquivo.

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

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

    Screenshot showing a new Visual Basic class file in the Visual Studio code editor.

Usar snippets de código

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

  1. Coloque o cursor acima da linha que indica End Class e digite sub.

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

    Screenshot showing the IntelliSense for a 'Sub' code snippet in Visual Studio.

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

    A estrutura do código do procedimento Sub MySub() é adicionada ao arquivo.

Os snippets de código disponíveis variam em linguagens de programação diferentes. 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:

Screenshot showing the Insert Snippet window with a list of category folders that contain Visual Basic code snippets.

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 indica End Class e digite sub.

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

    Screenshot showing the IntelliSense for a 'Sub' code snippet in Visual Studio.

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

    A estrutura do código do procedimento Sub MySub() é adicionada ao arquivo.

Os snippets de código disponíveis variam em linguagens de programação diferentes. Você pode examinar os snippets de código disponíveis para o Visual Basic abrindo o menu de contexto ou clique com o botão direito do mouse no editor de código e escolhendo Snippet>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:

Screenshot showing the Insert Snippet window with a list of category folders that contain Visual Basic code snippets.

Comentar o código

A barra de ferramentas, que é a linha de botões sob a barra de menus no Visual Studio, pode ajudar a aumentar sua produtividade durante a codificação. Por exemplo, você pode ativar/desativar o modo de preenchimento do IntelliSense, aumentar ou diminuir um recuo de linha ou comentar um código que não deseja compilar. (IntelliSense é um auxílio de codificação que exibe uma lista de métodos correspondentes, entre outras coisas.) Nesta seção, comentaremos sobre um código.

Screenshot showing the toolbar in Visual Studio which includes buttons for adding or removing code comments.

  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. Não estamos usando a matriz morewords, mas podemos usá-la mais tarde. Portanto, não queremos excluí-la por completo. Em vez disso, vamos comentar as linhas. Selecione a definição inteira de morewords até a chave de fechamento e, em seguida, escolha o botão Comentar as linhas selecionadas na barra de ferramentas. Caso prefira usar o teclado, pressione Ctrl+K, Ctrl+C.

    Screenshot showing the toolbar with the button for commenting out code highlighted in red.

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

Screenshot showing the toolbar in Visual Studio which includes buttons for adding or removing code comments.

  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. Não estamos usando a matriz morewords, mas podemos usá-la mais tarde. Portanto, não queremos excluí-la por completo. Em vez disso, vamos comentar as linhas. Selecione a definição inteira de morewords até a chave de fechamento e, em seguida, escolha o botão Comentar as linhas selecionadas na barra de ferramentas. Caso prefira usar o teclado, pressione Ctrl+K, Ctrl+C.

    Screenshot showing the toolbar with the button for commenting out code highlighted in red.

    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

Recolha seções de código para se concentrar apenas nas partes de seu interesse. Para praticar, vamos recolher a matriz _words para uma linha de código. Escolha a caixa cinza pequena com o sinal de subtração na margem da linha que indica Dim _words = New String() {. Ou, se você é um usuário de teclado, posicione o cursor em qualquer lugar da definição de matriz e pressione Ctrl+M, Ctrl+M.

Screenshot showing the Visual Studio Code editor, with the control for collapsing the outline of a section of code highlighted in red.

O bloco de código é recolhido apenas na primeira linha, seguido por um sinal de reticências (...). Para expandir o bloco de código novamente, clique na mesma caixa cinza que agora tem um sinal de adição ou pressione Ctrl+M, Ctrl+M novamente. Esse recurso é chamado de Estrutura de tópicos e é útil principalmente ao recolher métodos longos ou classes inteiras.

Recolha seções de código para se concentrar apenas nas partes de seu interesse. Para praticar, vamos recolher a matriz _words para uma linha de código. Escolha a caixa cinza pequena com o sinal de subtração na margem da linha que indica Dim _words = New String() {. Ou, se você é um usuário de teclado, posicione o cursor em qualquer lugar da definição de matriz e pressione Ctrl+M, Ctrl+M.

Screenshot showing the Visual Studio Code editor, with the control for collapsing the outline of a section of code highlighted in red.

O bloco de código é recolhido apenas na primeira linha, seguido por um sinal de reticências (...). Para expandir o bloco de código novamente, clique na mesma caixa cinza que agora tem um sinal de adição ou pressione Ctrl+M, Ctrl+M novamente. Esse recurso é chamado de Estrutura de tópicos e é útil principalmente ao recolher 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, método etc. Uma maneira é navegar até o arquivo que contém a definição, por exemplo, escolhendo 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. Vamos espiar a definição do tipo String.

  1. Clique com o botão direito do mouse na palavra String e escolha Inspecionar Definição no menu de conteúdo. Se preferir, pressione Alt+F12.

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

    Screenshot showing a Peek Definition pop-up window containing the definition of the 'String' class.

  2. Feche a janela de definição inspecionada ao selecionar a caixa pequena com um “x” 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. Uma maneira é navegar até o arquivo que contém a definição, por exemplo, ao selecionar Ir para Definição em qualquer lugar em que o símbolo esteja 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. Vamos espiar a definição do tipo String.

  1. Clique com o botão direito do mouse na palavra String e escolha Inspecionar Definição no menu de conteúdo. Se preferir, pressione Alt+F12.

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

    Screenshot showing a Peek Definition pop-up window containing the definition of the 'String' class.

  2. Feche a janela Espiar Definição ao selecionar a caixa pequena com um “x” no canto superior direito da janela pop-up.

Usar o IntelliSense para completar palavras

O IntelliSense é um recurso valioso quando você está gravando o código. 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 completar uma palavra depois que você digitar caracteres suficientes para desambiguá-la. Vamos 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 código a seguir:

    For Each str In qu
    

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

    Screenshot showing the IntelliSense word completion window for the word 'query' in the Visual Studio code editor.

  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
    

O IntelliSense é um recurso valioso quando você está gravando o código. 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 completar uma palavra depois que você digitar caracteres suficientes para desambiguá-la. Vamos 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 código a seguir:

    For Each str In qu
    

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

    Screenshot showing the IntelliSense word completion window for the word 'query' in the Visual Studio code editor.

  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
    

Refatorar um nome

Ninguém obtém o código correto na primeira vez e uma das coisas que talvez você precise alterar é o nome de uma variável ou de um método. Vamos experimentar a funcionalidade de refatorar do Visual Studio para renomear a variável _words como words.

  1. Coloque o cursor sobre a definição da variável _words e escolha Renomear no menu de atalho ou de contexto.

    Uma caixa de diálogo pop-up chamada Renomear aparecerá no canto superior direito do editor.

  2. Com a variável _words ainda selecionada, digite o nome desejado de words. Observe que a referência ao words na consulta também será renomeada automaticamente. Antes de pressionar Enter ou clicar em Aplicar, marque a caixa de seleção Incluir comentários na caixa pop-up Renomear.

    Screenshot showing the Rename dialog box for the variable '_words', with the option for 'Include comments' checked.

  3. Pressione Enter ou clique em Aplicar.

    As duas ocorrências de words serão renomeadas, bem como a referência a words no comentário do código.

Ninguém obtém o código correto na primeira vez e uma das coisas que talvez você precise alterar é o nome de uma variável ou de um método. Vamos experimentar a funcionalidade de refatorar do Visual Studio para renomear a variável _words como words.

  1. Coloque o cursor sobre a definição da variável _words e escolha Renomear no menu de atalho ou de contexto.

    Uma caixa de diálogo pop-up chamada Renomear aparecerá no canto superior direito do editor.

  2. Com a variável _words ainda selecionada, digite o nome desejado de words. Observe que a referência ao words na consulta também será renomeada automaticamente. Antes de pressionar Enter ou Aplicar, marque a caixa de seleção Incluir comentários na caixa pop-up Renomear.

    Screenshot showing the Rename dialog box for the variable '_words', with the option for 'Include comments' checked.

  3. Pressione Enter ou escolha Aplicar.

    As duas ocorrências de words serão renomeadas, bem como a referência a words no comentário do código.

Próximas etapas

Confira também