Compartilhar via


Saiba como usar o editor de código

Nesta introdução ao editor de código do Visual Studio, você adicionará código a um arquivo e explorará como o Visual Studio ajuda a facilitar a escrita, a navegação e a compreensão do código.

Tip

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

Se você ainda não instalou 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 uma linguagem de programação. Se não estiver, sugerimos que você examine uma das introduções rápidas à programação primeiro, como criar um aplicativo Web com Python ou C# , ou criar um aplicativo de console com Visual Basic ou C++ .

Prerequisites

Criar um novo arquivo de código

Crie um novo arquivo e adicione 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 Visual C# e, em seguida, selecione Abrir.

    Um novo arquivo é aberto no editor com o esqueleto de uma classe C#. (Observe que não precisamos criar um projeto completo do Visual Studio para obter alguns dos benefícios que o editor de código oferece; tudo o que você precisa é de um arquivo de código!)

    captura de tela de um arquivo de código C# no Visual Studio.

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

  2. No menu Arquivo na barra de menu, selecione Novo>Arquivo ou selecione Ctrl+N.

  3. Na caixa de diálogo Novo Arquivo , na categoria Geral , selecione Classe C# e, em seguida, selecione Abrir.

    Um novo arquivo é aberto no editor com uma estrutura de classe C# básica.

    Captura de tela de um arquivo de código C# no Visual Studio 2022.

Usar o GitHub Copilot

O GitHub Copilot atua como um programador de pares de IA para fornecer preenchimentos de código no estilo de preenchimento automático e sugestões de código de várias linhas com reconhecimento de contexto, conforme você codifica, em tempo real, diretamente no editor. O GitHub Copilot transforma prompts de linguagem natural, incluindo comentários e nomes de método em sugestões de codificação. Você pode exibir e incorporar sugestões do GitHub Copilot diretamente no editor.

Vamos usar Copilot para gerar sugestões de código:

  1. Coloque o cursor logo abaixo da chave de fechamento final } no arquivo.

  2. Digite um comentário de linguagem natural: // Add a method to add two numbers e Insira.

  3. O GitHub Copilot gera uma sugestão de código para você. A implementação sugerida é exibida em texto cinza.

  4. Para aceitar a sugestão, selecione Tab.

    Captura de tela animada que mostra as sugestões de código geradas pelo GitHub Copilot para o comentário do usuário.

Vamos usar o Copilot Chat para enviar uma pergunta relacionada à codificação como um prompt:

  1. Selecione o selo Do GitHub Copilot no canto superior direito do IDE.

  2. Selecione Abrir Janela de Chat na lista suspensa.

  3. Insira o seguinte prompt na janela de chat:

    
    Generate sample code for a simple C# method to add two numbers.
    
    
  4. O Copilot Chat gera um código de exemplo em resposta ao seu prompt.

O GitHub Copilot é alimentado pela IA, portanto, surpresas e erros são possíveis. Para obter mais informações, consulte perguntas frequentes sobre o GitHub Copilot.

Introdução ao GitHub Copilot no Visual Studio.

Usar snippets de código

O Visual Studio fornece snippets de código úteis que você pode usar para gerar rapidamente blocos de código comumente usados. Snippets de código estão disponíveis para várias linguagens de programação, incluindo C#, Visual Basic e C++.

Agora, adicione o snippet de código C# void Main ao arquivo.

  1. Coloque o cursor logo acima da chave de fechamento final } no arquivo e digite os caracteres svm. (svm significa static void Main; o método Main() é o ponto de entrada para aplicativos C#.)

    Uma caixa de diálogo pop-up é exibida com informações sobre o snippet de código svm.

    Captura de tela de um pop-up do IntelliSense para um trecho de código no Visual Studio.

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

    Você verá a assinatura do método static void Main() ser adicionada ao arquivo.

Os snippets de código disponíveis variam para diferentes linguagens de programação. Você pode examinar os snippets de código disponíveis para seu idioma escolhendo Editar>IntelliSense>Inserir Trechoe, em seguida, escolher a pasta do seu idioma. Para C#, a lista tem esta aparência:

Captura de tela de um pop-up do IntelliSense para uma lista de snippets de código em C#.

  1. Coloque o cursor logo acima da chave de fechamento final } no arquivo e digite os caracteres svm.

    Uma caixa de diálogo pop-up é exibida com informações sobre o snippet de código svm.

    Captura de tela de um item pop-up do IntelliSense para um snippet de código no Visual Studio 2022.

  2. Selecione a tecla Tab duas vezes para inserir o snippet de código.

    Você verá a assinatura do método static void Main() ser adicionada ao arquivo. O método Main() é o ponto de entrada para aplicativos C#.

Os snippets de código disponíveis variam de acordo com a linguagem de programação. Para exibir os snippets de código disponíveis para seu idioma, vá para Editar>Trecho de Inserção> ou selecione Ctrl+K, Teclas Ctrl+X e selecione a pasta para sua linguagem de programação. Para C#, a lista de snippets de código tem esta aparência:

Captura de tela de um pop-up do IntelliSense para uma lista de snippets de código em C#.

A lista inclui snippets para a criação de uma classe, um construtor, um loop for, uma instrução if ou switch e muito mais.

Comentar o código

A barra de ferramentas, que é a linha de botões na barra de menus no Visual Studio, pode ajudar a torná-lo mais produtivo conforme você codifica. Por exemplo, você pode alternar o modo de conclusão do IntelliSense (intelliSense é um auxílio de codificação que exibe uma lista de métodos correspondentes, entre outras coisas), aumentar ou diminuir um recuo de linha ou comentar o código que você não deseja compilar. Nesta seção, comentaremos algum código.

Captura de tela da barra de ferramentas do Editor no Visual Studio.

  1. Cole o código a seguir no corpo do método Main().

    // _words is a string array that we'll sort alphabetically
    string[] _words = {
        "the",
        "quick",
        "brown",
        "fox",
        "jumps"
    };
    
    string[] morewords = {
        "over",
        "the",
        "lazy",
        "dog"
    };
    
    IEnumerable<string> query = from word in _words
                                orderby word.Length
                                select word;
    
  2. Não estamos usando a variável morewords, mas podemos usá-la mais tarde para que não queiramos excluí-la completamente. Em vez disso, vamos comentar as linhas. Selecione a definição inteira de morewords até o ponto e vírgula de fechamento e, em seguida, escolha o botão Comentar as linhas selecionadas na barra de ferramentas. Se preferir usar o teclado, pressione Ctrl+K, Ctrl+C.

    Captura de tela do botão Assinalar como comentário na barra de ferramentas do editor no Visual Studio.

    Os caracteres de comentário em C# // são adicionados ao início de cada linha selecionada para comentar o código.

A barra de ferramentas do Editor de Texto, a linha de botões na barra de menus no Visual Studio, ajuda a torná-lo mais produtivo conforme você codifica. Por exemplo, você pode alternar o modo de conclusão do IntelliSense , aumentar ou diminuir um recuo de linha ou comentar o código que não deseja compilar.

Captura de tela da barra de ferramentas do Editor de Texto no Visual Studio 2022.

Vamos assinalar um código como comentário.

  1. Cole o código a seguir no corpo do método Main().

    // someWords is a string array.
    string[] someWords = {
        "the",
        "quick",
        "brown",
        "fox",
        "jumps"
    };
    
    string[] moreWords = {
        "over",
        "the",
        "lazy",
        "dog"
    };
    
    // Alphabetically sort the words.
    IEnumerable<string> query = from word in someWords
                                orderby word
                                select word;
    
  2. A moreWords variável não está sendo usada no momento, mas você pode usá-la mais tarde, portanto, em vez de excluí-la, você pode comentar essas linhas. Selecione toda a definição de moreWords até o ponto e vírgula de fechamento, e então escolha o botão Comentar as linhas selecionadas na barra de ferramentas do Editor de Texto, ou selecione Ctrl+K, Ctrl+C.

    Captura de tela do botão Comentar na barra de ferramentas do Editor de Texto no Visual Studio 2022.

    Os caracteres de comentário em C# // são adicionados ao início de cada linha selecionada para comentar o código.

    Para descompactar linhas, selecione-as e, em seguida, descompacte o botão Descompactar as linhas selecionadas na barra de ferramentas do Editor de Texto ou selecione Ctrl+K, Ctrl+U.

    Captura de tela do botão Descomentar na barra de ferramentas do Editor de Texto no Visual Studio 2022.

Recolher blocos de código

Não queremos ver o construtor vazio para Class1 que foi gerado. Portanto, para desobstruir nossa exibição do código, vamos recolhê-la. Escolha a pequena caixa cinza com o sinal de subtração dentro da margem da primeira linha do construtor. Ou, se preferir usar o teclado, coloque o cursor em qualquer lugar no código do construtor e pressione Ctrl+M, Ctrl+M.

Captura de tela do botão Recolher estrutura de tópicos na barra de ferramentas do editor de texto no Visual Studio.

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 Outline e é especialmente útil quando você está reduzindo métodos longos ou classes inteiras.

Se você não quiser ver o construtor vazio para que foi gerado para Class1, você pode recolhê-lo para facilitar a exibição do código. Selecione o sinal de cursor na margem da primeira linha do construtor. Ou, se preferir usar o teclado, coloque o cursor em qualquer lugar no código do construtor e selecione as teclas Ctrl+M, Ctrl+M.

Captura de tela do botão de recolhimento de contorno na barra de ferramentas do Editor de texto.

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, selecione o sinal de cursor (>) ou selecione Ctrl+M, Ctrl+M novamente. Esse recurso é chamado Outline e é especialmente útil quando você está reduzindo 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 seja 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 examinar a definição do tipo string.

  1. Clique com o botão direito do mouse em qualquer ocorrência de string e escolha Espiar Definição no menu de conteúdo. Ou pressione Alt+F12.

    Uma janela pop-up é 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.

    Captura de tela de uma janela Espiar Definição no Visual Studio.

  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, método ou variável. Uma maneira é ir para a definição, em qualquer arquivo que a tenha, escolhendo Ir para Definição ou selecionando a tecla F12 em qualquer lugar em que um símbolo seja referenciado. Uma maneira ainda mais rápida que não desvia seu foco do código em que você está trabalhando é usar Peek Definition.

Vamos examinar a definição do tipo string.

  1. Clique com o botão direito do mouse em qualquer ocorrência de string e escolha Espiar Definição no menu de conteúdo. Ou selecione as teclasAlt+ F12.

    Uma janela pop-up é 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.

    Captura de tela da janela Espiar definição no Visual Studio.

  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 concluir palavras

IntelliSense é um recurso inestimável 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. Vamos adicionar uma linha de código para imprimir as strings ordenadas na janela do console, que é o local padrão para onde a saída do programa é direcionada.

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

    foreach (string str in qu
    

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

    Captura de tela de um pop-up de conclusão de palavras do IntelliSense no Visual Studio.

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

  3. Complete o bloco de código para que ele se pareça com o código a seguir. Você pode até mesmo praticar o uso de snippets de código novamente inserindo cw e pressionando Tab duas vezes para gerar o código Console.WriteLine.

    foreach (string str in query)
    {
       Console.WriteLine(str);
    }
    

IntelliSense é um recurso inestimável 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.

Vamos adicionar uma linha de código para imprimir as strings ordenadas na janela do console, que é o local padrão para onde a saída do programa é direcionada.

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

    foreach (string str in qu
    

    Você verá um pop-up do IntelliSense aparecer com informações sobre o símbolo de query.

    Captura de tela de um pop-up de conclusão de palavras do IntelliSense no Visual Studio 2022.

    Se você estiver conectado com uma conta do GitHub que tenha uma assinatura Copilot, você também verá sugestões de código aparecerem em cinza.

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

  3. Complete o bloco de código para que ele se pareça com o código a seguir. Você pode praticar mais com trechos de código inserindo cw e depois selecionando Tab duas vezes para gerar a declaração Console.WriteLine.

    foreach (string str in query)
    {
       Console.WriteLine(str);
    }
    

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. 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 contexto (clicando com o botão direito do mouse) ou pressione Ctrl+R, Ctrl+R.

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

  2. Insira o nome desejado words. Observe que a referência a words na consulta também é renomeada automaticamente. Antes de pressionar Enter, marque a caixa de seleção Incluir Comentários na caixa pop-up Renomear.

    Captura de tela de uma caixa de diálogo Renomear no Visual Studio.

  3. Pressione Enter.

    Ambas as ocorrências de words foram renomeadas, bem como a 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. Vamos experimentar a funcionalidade de refatorar do Visual Studio para renomear a variável someWords como unsortedWords.

  1. Coloque o cursor sobre a definição da variável someWords e selecione Renomear ao clicar com o botão direito do mouse ou no menu de contexto, ou selecione a chave F2.

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

    Captura de tela da caixa pop-up Renomear no editor do Visual Studio 2022.

  2. Insira o nome desejado unsortedWords. Você verá que a referência a unsortedWords na instrução de atribuição query também é renomeada automaticamente. Antes de pressionar a tecla Enter, marque a caixa de seleção Incluir comentários na caixa pop-up Renomear.

    Captura de tela da caixa pop-up Renomear no Visual Studio 2022.

  3. Selecione a tecla Enter.

    Ambas as ocorrências de someWords em seu código foram renomeadas, assim como o texto someWords em seu comentário de código.

Próximas etapas

Consulte também