Saiba como usar o editor de códigos com C#

Artigo
06/19/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 C#.

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 C#. Caso contrário, sugerimos que você primeiro examine um tutorial, como Introdução ao C# e ao ASP.NET Core no Visual Studio.

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 ou pressione Ctrl+N.
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. Pressione 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 pressione Ctrl+N.
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#. Não é necessário 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.

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 (que significam static void Mainnão se preocupe muito se você não sabe o que isso significa).

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. 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. Examine os snippets de código disponíveis para a linguagem escolhendo Editar>IntelliSense>Inserir Snippet ou pressionando Ctrl+K, Ctrl+X 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. svm significa static void Main— não se preocupe se você ainda não sabe o que isso significa.

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. O método Main() é o ponto de entrada para aplicativos C#.

Os snippets de código disponíveis variam conforme as diferentes linguagens de programação. Você pode examinar os snippets de código disponíveis para sua linguagem selecionando Editar>IntelliSense>Inserir Snippet ou pressionando 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 Assinalar como comentário 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, 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 assinalar como comentário 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 assinalar as linhas como comentário. Selecione a definição inteira de moreWords até o ponto e vírgula de fechamento e, em seguida, escolha o botão Assinalar como comentário 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.

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.

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 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 ou pressionando F12 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 pressionando 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 a opção Espiar 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 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 pressionando 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 ao pressione 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 Enter, marque a caixa de seleção Incluir Comentários na caixa pop-up Renomear.
Pressione Enter ou escolha Aplicar na caixa de diálogo Renomear.

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