Partilhar via


Aprenda a usar o editor de código com C#

Nesta introdução de 10 minutos ao editor de código no Visual Studio, adicionaremos código a um arquivo para examinar algumas das maneiras pelas quais o Visual Studio facilita a escrita, a navegação e a compreensão do código C#.

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

Este artigo pressupõe que você já esteja familiarizado com C#. Se você não estiver, sugerimos que você veja um tutorial como Introdução ao C# e ASP.NET Core no Visual Studio primeiro.

Dica

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

Criar um novo arquivo de código

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

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

  2. No menu Arquivo na barra de menus, escolha Novo>Arquivoou pressione Ctrl+N.

  3. Na caixa de diálogo New File, na categoria General, escolha Visual C# Classe, em seguida, escolha 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. Pressione Escou escolha Continuar sem código na janela Iniciar para abrir o ambiente de desenvolvimento.

  2. Na barra de menus, no menu Arquivo, escolha Novo>Arquivo, ou pressione Ctrl+N.

  3. Na caixa de diálogo New File, na categoria General, escolha Visual C# Classe, em seguida, escolha Abrir.

    Um novo arquivo é aberto no editor com o esqueleto de uma classe C#. Você não precisa 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 2022.

Usar trechos de código

O Visual Studio fornece trechos de código úteis que você pode usar para gerar rápida e facilmente blocos de código comumente usados. trechos de código estão disponíveis para diferentes linguagens de programação, incluindo C#, Visual Basic e C++.

Vamos adicionar o trecho de C# void Main ao nosso arquivo.

  1. Coloque o cursor logo acima da chave de fechamento final } no arquivo e digite os caracteres svm (que significa static void Main—nã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 trecho de código svm.

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

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

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

Os trechos de código disponíveis variam para diferentes linguagens de programação. Você pode ver os trechos de código disponíveis para o seu idioma escolhendo Editar>IntelliSense>Inserir Trecho ou pressionando Ctrl+K, Ctrl+Xe, em seguida, escolhendo 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 trechos de código C#.

  1. 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 trecho de código svm.

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

  2. Pressione Tab duas vezes para inserir o trecho 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 trechos de código disponíveis variam para diferentes linguagens de programação. Você pode ver os trechos de código disponíveis para seu idioma escolhendo Editar>IntelliSense>Inserir Fragmento ou pressionando Ctrl+K, Ctrl+X, e, em seguida, escolhendo a pasta para sua linguagem de programação. Para C#, a lista de trechos tem esta aparência:

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

A lista inclui trechos para criar um classe, um construtor, um para loop, um if ou switch declaração 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 torná-lo mais produtivo à medida que 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 alguns códigos.

Captura de tela da barra de ferramentas 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, então não queremos excluí-la completamente. Em vez disso, vamos comentar essas linhas. Selecione toda a definição de morewords até ao ponto-e-vírgula de fecho e, em seguida, escolha o botão Comentar as linhas selecionadas na barra de ferramentas. Se preferir usar o teclado, pressione Ctrl+KCtrl+C.

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

    Os caracteres de comentário 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 torná-lo mais produtivo à medida que codifica. Por exemplo, pode alternar entre o modo de conclusão do IntelliSense, aumentar ou diminuir o recuo de uma linha, ou comentar o código que não quer compilar.

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

Vamos comentar um pouco de código.

  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. Não estamos usando a variável moreWords, mas podemos usá-la mais tarde, então não queremos excluí-la. Em vez disso, comentaremos essas linhas. Selecione toda a definição de moreWords até ao 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+E, 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 C# // são adicionados ao início de cada linha selecionada para comentar o código.

Recolher blocos de código

Não queremos ver o de construtor de vazio que foi gerado para Class1, então para organizar nossa visão do código, vamos colapsá-lo. Escolha a pequena caixa cinza com o sinal de menos dentro dela 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 pressione Ctrl+M, Ctrl+M.

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

O bloco de código é reduzido à primeira linha, seguido por reticências (...). Para expandir o bloco de código novamente, clique na mesma caixa cinza que agora tem um sinal de mais ou pressione Ctrl+MCtrl+M novamente. Esse recurso é chamado de Estrutura de Tópicos e é especialmente útil quando você está recolhendo métodos longos ou classes inteiras.

Captura de tela do botão de recolhimento da estrutura de tópicos na barra de ferramentas do Editor de Texto no Visual Studio 2022.

O bloco de código encolhe para mostrar apenas a primeira linha, seguida por três pontos (...). Para expandir o bloco de código novamente, selecione a mesma caixa cinza que agora tem um sinal de mais ou pressione Ctrl+MCtrl+M novamente. Esse recurso é chamado de Estrutura de Tópicos e é especialmente útil quando você está recolhendo métodos longos ou classes inteiras.

Ver definições de símbolos

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 qualquer lugar em que o símbolo seja referenciado. Uma maneira ainda mais rápida de não desviar seu foco do arquivo em que você está trabalhando é usar Peek Definition. Vamos espreitar 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 contexto. Ou pressione Alt+F12.

    Uma janela pop-up aparece com a definição da classe String. Você pode rolar dentro da janela pop-up, ou até mesmo espreitar a definição de outro tipo a partir do código espiado.

    Captura de ecrã de uma janela de definição Peek no Visual Studio.

  2. Feche a janela de definição espiada escolhendo a pequena caixa 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 pressionando F12 qualquer lugar onde um símbolo seja referenciado. Uma maneira ainda mais rápida de não desviar seu foco do código em que você está trabalhando é usar Peek Definition.

Vamos espreitar a definição do tipo string.

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

    Uma janela pop-up aparece com a definição da classe String. Você pode deslocar dentro de uma janela pop-up, ou até mesmo espreitar a definição de outro tipo a partir do código visualizado.

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

  2. Feche a janela de pré-visualização clicando na pequena caixa com um "x" no canto superior direito da janela.

Use o IntelliSense para completar palavras

IntelliSense é um recurso inestimável quando você está codificando. Ele pode mostrar informações sobre membros disponíveis de um tipo ou detalhes de parâmetros para diferentes sobrecargas de um método. Você também pode usar o IntelliSense para completar uma palavra depois de digitar caracteres suficientes para desambiguá-la. Vamos 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 do programa.

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

    foreach (string str in qu
    

    O IntelliSense mostra-lhe Informações Rápidas sobre o símbolo query.

    Captura de ecrã de um pop-up de conclusão de palavra IntelliSense no Visual Studio.

  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 se pareça com o código a seguir. Você pode até mesmo praticar o uso de trechos de código novamente digitando cw e, em seguida, 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á codificando. Ele pode mostrar informações sobre membros disponíveis de um tipo ou detalhes de parâmetros para diferentes sobrecargas de um método. Você também pode usar o IntelliSense para completar uma palavra depois de digitar caracteres suficientes para desambiguá-la.

Vamos 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 do programa.

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

    foreach (string str in qu
    

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

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

  2. Para inserir o resto da palavra query utilizando a funcionalidade de conclusão de palavras do IntelliSense, pressione Tab.

  3. Conclua o bloco de código para que se pareça com o código a seguir. Você pode praticar ainda mais com trechos de código digitando cw e, em seguida, pressionando Tab duas vezes para gerar a instruçã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 de refatoramento de do Visual Studio para renomear a variável _words para words.

  1. Coloque o cursor sobre a definição da variável _words e escolha Renomear clicando com o botão direito do rato no menu de contexto ou pressione Ctrl+R, Ctrl+R.

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

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

    Captura de ecrã 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 de refatoramento de do Visual Studio para renomear a variável someWords para unsortedWords.

  1. Coloque o cursor sobre a definição da variável someWords e escolha Renomear no menu de contexto clicando com o botão direito do rato, ou pressione F2.

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

    Captura de tela da caixa pop-up de renomeação no editor do Visual Studio 2022.

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

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

  3. Pressione Enterou escolha Aplicar na caixa de diálogo Renomear.

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

Próximos passos

Ver também