Saiba como usar o editor de códigos

Artigo
12/22/2023

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.

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 considera que você já esteja familiarizado com uma linguagem de programação. Se não estiver, sugerimos que você confira um dos tutoriais de programação, por exemplo, como criar um aplicativo Web com Python ou C#, ou criar um aplicativo de console com Visual Basic ou C++.

Dica

Para acompanhar este artigo, verifique se você tem as configurações do C# 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.

Abra o Visual Studio. Pressione Esc ou clique em Continuar sem código na janela de início para abrir o ambiente de desenvolvimento.
No menu Arquivo na barra de menus, escolha Novo>Arquivo.
Na caixa de diálogo Novo Arquivo, na categoria Geral, escolha Classe do Visual C# e, então, selecione Abrir.

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

Abra o Visual Studio. Selecione a tecla Esc ou escolha Continuar sem código na janela de início para abrir o ambiente de desenvolvimento.
No menu Arquivo na barra de menus, escolha Novo>Arquivo ou selecione as teclas Ctrl+N.
Na caixa de diálogo Novo Arquivo, na categoria Geral, escolha Classe C# e, em seguida, Abrir.

Um novo arquivo é aberto no editor com o esqueleto de uma classe de C#.

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.

Experimente o GitHub Copilot

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

Coloque o cursor logo abaixo da chave de fechamento final } no arquivo.
Digite um comentário de linguagem natural: // Add a method to add two numbers e Enter.
O GitHub Copilot gera uma sugestão de código para você. A implementação sugerida é exibida em texto cinza.
Para aceitar a sugestão, selecione Tab.

Introdução ao GitHub Copilot no Visual Studio. Observe que ele requer o Visual Studio 2022 17.5.5 ou posterior.

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 linguagens de programação diferentes, incluindo C#, Visual Basic e C++.

Vamos adicionar o snippet void Main de C# em nosso arquivo.

Coloque o cursor logo acima da chave de fechamento final } no arquivo e digite os caracteres svm. (svm representa 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.
Pressione a Guia duas vezes para inserir o snippet de código.

Você verá que a assinatura do método static void Main() será 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 a linguagem escolhendo Editar>IntelliSense>Inserir Snippet e, em seguida, escolhendo a pasta da linguagem. Para o C#, a lista tem este aspecto:

Screenshot of an IntelliSense pop-up for a C# code snippet list.

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.
Selecione a tecla Tab duas vezes para inserir o snippet de código.

Você verá que 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 em linguagens de programação diferentes. Você pode examinar os snippets de código disponíveis para sua linguagem selecionando Editar>IntelliSense>Inserir Snippet ou selecionando as teclas Ctrl+K, Ctrl+X, e, em seguida, escolhendo a pasta para sua linguagem de programação. Para o C#, a lista de snippet tem este aspecto:

Screenshot of an IntelliSense pop-up for a C# code snippet list.

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 sob a barra de menus no Visual Studio, pode ajudar a aumentar sua produtividade durante a codificação. Por exemplo, você pode alternar o modo de preenchimento do IntelliSense (o IntelliSense é um recurso de codificação que exibe uma lista de correspondência de métodos, entre outras coisas), aumentar ou diminuir um recuo de linha ou comentar um código que você não deseja compilar. Nesta seção, comentaremos alguns códigos.

Screenshot of the Editor toolbar in Visual Studio.

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;

Não estamos usando a variável 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é o ponto e vírgula 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.

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

A barra de ferramentas Editor de Texto, que é a linha de botões sob a barra de menus no Visual Studio, ajuda 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.

Screenshot of the Text Editor toolbar in Visual Studio 2022.

Vamos assinalar um código como comentário.

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;

Não usaremos a variável moreWords, mas, como podemos usá-la posteriormente, não desejamos excluí-la. 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 do Editor de Texto. Caso prefira usar o teclado, selecione Ctrl+K, Ctrl+C.

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

Quando quiser remover marca de comentário das linhas, você pode selecioná-las e, em seguida, escolher o botão Remover marca de comentário das linhas selecionadas na barra de ferramentas do editor de texto. Caso prefira usar o teclado, selecione Ctrl+K, Ctrl+U.

Recolher blocos de código

Como não desejamos ver o construtor vazio que foi gerado para Class1, vamos recolhê-lo para que o código não seja mais exibido. Escolha a pequena caixa cinza com o sinal de subtração dentro da margem da primeira linha do construtor. Ou, se você preferir usar o teclado, posicione o cursor em qualquer lugar no código do construtor e pressione Ctrl+M, Ctrl+M.

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.

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 você preferir usar o teclado, posicione o cursor em qualquer lugar no código do construtor e selecione as teclas Ctrl+M, Ctrl+M.

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 a mesma caixa cinza que agora tem um sinal de adição ou selecione 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.

Clique com o botão direito do mouse em qualquer ocorrência de string e escolha Espiar 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.
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, de um método ou variável. Uma maneira é ir para a definição, em qualquer arquivo que o 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 move o foco para fora do código em que você está trabalhando é usar a opção Inspecionar Definição.

Vamos espiar a definição do tipo string.

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 teclas 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.
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.

Abaixo da variável query, comece a digitar o código a seguir:
```
foreach (string str in qu
```
Você verá o IntelliSense mostrar as Informações Rápidas sobre o símbolo query.
Para inserir o restante da palavra query usando a funcionalidade de preenchimento de palavras do IntelliSense, pressione Tab.
Finalize o bloco de código para que ele se pareça com o seguinte código. Você mesmo pode praticar usando os snippets de código novamente ao inserir cw e, então, pressionar a Guia duas vezes para gerar o código Console.WriteLine.
```
foreach (string str in query)
{
   Console.WriteLine(str);
}
```

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.

Abaixo da variável query, comece a digitar o código a seguir:
```
foreach (string str in qu
```
Você verá um item pop-up do IntelliSense aparecer com informações sobre o símbolo query.
Para inserir o restante da palavra query usando o preenchimento de palavras do IntelliSense, selecione a tecla Tab.
Finalize o bloco de código para que ele se pareça com o seguinte código. Você pode praticar mais com snippets de código inserindo cw e selecionando Tab duas vezes para gerar a instrução Console.WriteLine.
```
foreach (string str in query)
{
   Console.WriteLine(str);
}
```

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.

Coloque o cursor sobre a definição da variável _words e selecione Renomear ao clicar com o botão direito do mouse ou no menu de contexto, ou ao pressionar Ctrl+R, Ctrl+R.

Uma caixa de diálogo pop-up chamada Renomear aparecerá no canto superior direito do editor.
Insira o nome desejado words. Observe que a referência ao words na consulta também será renomeada automaticamente. Antes de pressionar Enter, marque a caixa de seleção Incluir Comentários na caixa pop-up Renomear.
Pressione Enter.

As duas ocorrências de words foram renomeadas, bem como a referência ao words do comentário de código.

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.
Insira o nome desejado unsortedWords. Você verá que a referência ao unsortedWords na instrução de atribuição query também será renomeada automaticamente. Antes de pressionar a tecla Enter, marque a caixa de seleção Incluir comentários na caixa pop-up Renomear.
Pressione a tecla Enter.

As duas ocorrências de someWords no seu código foram renomeadas, bem como o texto someWords no comentário de código.

Próximas etapas

Saiba mais sobre projetos e soluções

Compartilhar via