Executar um programa ou aplicativo C# no Visual Studio

Como executar um programa ou iniciar uma aplicação depende do ponto de início, do tipo de programa ou aplicação, e se se deseja executar sob o depurador. No caso mais simples, para criar e executar um projeto aberto no Visual Studio:

• Pressione F5, escolha Depurar>Iniciar com depuração no menu do Visual Studio ou selecione a seta verde Iniciar e o nome do projeto na barra de ferramentas do Visual Studio.
• Ou, para executar sem depuração, pressione Ctrl+F5 ou escolha Depurar>Iniciar sem depurar no menu do Visual Studio.

Começar a partir de um projeto

Você pode executar um projeto C# (arquivo.csproj) se for um programa executável. Se o projeto contiver um arquivo C# com um método Main e sua saída for um arquivo executável ou .exe, ele provavelmente será executado se for compilado com êxito. Se a saída do projeto for um arquivo executável e não tiver um método Main, as execuções do programa começarão com instruções de nível superior. Consulte Programas sem métodos principais. Alguns tipos de projeto, como bibliotecas de classes, não podem ser executados. As bibliotecas de classes não podem ser executadas por conta própria, mas podem ser referenciadas por outros projetos.

Se você não tiver certeza se o projeto que você tem é um arquivo executável, selecione o nó do projeto no Gerenciador de Soluções e abra as propriedades do projeto. Clique com o botão direito do mouse no nó para abrir o menu de contexto e escolha Propriedadesou pressione Alt+Enter. Na seção do Application, procure o tipo de saída Output. Se for Aplicativo de Console, então é um programa executável.

1. Abra o projeto. Para fazer isso, você pode clicar duas vezes ou tocar no arquivo .csproj no Explorador de Arquivos do Windows ou escolher Abrir um de projeto no Visual Studio, procurar para localizar o arquivo .csproj e selecionar o arquivo.

2. Depois que o projeto for carregado no Visual Studio, se sua solução do Visual Studio tiver mais de um projeto, certifique-se de definir o projeto com o método Main como o projeto de inicialização. Para definir o projeto de inicialização, clique com o botão direito do mouse no nome ou nó do projeto em Gerenciador de Soluções e escolha Definir como Projeto de Inicialização no menu de contexto.

   

3. Para executar o programa, pressione Ctrl+F5, selecione Depurar>Iniciar sem depurar no menu superior ou selecione o botão verde Iniciar.

   Visual Studio tenta criar e executar seu projeto. Na parte inferior da tela do Visual Studio, a saída de compilação aparece na janela Output e todos os erros de compilação aparecem na janela Lista de Erros .

   Se a compilação for bem-sucedida, o aplicativo será executado conforme apropriado para o tipo de projeto. Os aplicativos de console são executados em uma janela de terminal, os aplicativos da área de trabalho do Windows são iniciados em uma nova janela da área de trabalho e os aplicativos Web são executados em um navegador hospedado pelo IIS Express.

Começar a partir do código

Se tiver um exemplo de código C# executável em mente, como este, ou um arquivo de código C# executável ou arquivos no disco, siga estas etapas.

Primeiro, certifique-se de que o código é um programa executável de uma fonte confiável. Qualquer aplicativo com um método Main é provavelmente um programa executável, mas com a versão atual do C#, programas sem métodos Main com instruções de nível superior também podem ser executados. Você pode usar o modelo Aplicativo de Console para criar um projeto no Visual Studio e, em seguida, copiar o código para ele.

Um único arquivo de código

1. Inicie o Visual Studio, escolha Criar um novo projetoe escolha o C# Console App projeto.
2. Substitua todo o código no arquivo de .cs do projeto pelo conteúdo do seu código ou arquivo. Se o código que você deseja usar estiver na Web ou em um único arquivo, talvez seja mais fácil selecionar o código, copiá-lo para a área de transferência e colá-lo em um arquivo de código no projeto do Visual Studio.
3. Renomeie o arquivo de .cs do projeto para corresponder ao nome do arquivo de código.

Vários arquivos de código no disco

1. Inicie o Visual Studio e crie um novo projeto do tipo apropriado. Use o aplicativo C# Console se não tiver certeza.
2. No novo projeto, substitua todo o código no arquivo de código do projeto com o conteúdo da sua primeira listagem de código ou arquivo.
3. Renomeie o arquivo de código do projeto para corresponder ao nome do arquivo de código.
4. Para cada arquivo de código restante:
   1. Clique com o botão direito do mouse no nó do projeto no Gerenciador de Soluções e escolha Adicionar>Item já Existente, ou selecione o projeto e pressione Shift+Alt+A.
   2. Procure e selecione o arquivo de código para importá-lo para o projeto.

Vários arquivos em uma pasta

Se você tiver uma pasta com muitos arquivos, primeiro verifique se há um arquivo de projeto ou solução. Programas que o Visual Studio cria têm arquivos de projeto e solução. No Explorador de Ficheiros do Windows, procure ficheiros com a extensão .csproj ou .sln. Clique duas vezes no arquivo .csproj para abri-lo no Visual Studio. Consulte Iniciar a partir de uma solução ou projeto do Visual Studio.

Se o código for de outro ambiente de desenvolvimento, não há nenhum arquivo de projeto. Abra a pasta escolhendo Abrir pastano Visual Studio. Consulte Desenvolver código sem projetos ou soluções.

Iniciar a partir de um repositório GitHub ou Azure DevOps

Se o código que você deseja executar estiver em um repositório GitHub ou Azure DevOps, você poderá usar o Visual Studio para abrir o projeto diretamente do repositório. Veja Abrir um projeto a partir de um repositório.

Execute o programa

Para começar a criar o programa, pressione o botão verde Iniciar na barra de ferramentas do Visual Studio ou pressione F5 ou Ctrl+F5. Usando o botão Iniciar ou F5 executa o programa sob o depurador.

Visual Studio tenta criar e executar o código em seu projeto. Se uma compilação não for bem-sucedida, consulte as seções a seguir para obter algumas ideias sobre como fazer com que o projeto seja compilado com êxito.

Solução de problemas

Seu código pode ter erros. Ou o código pode estar correto, mas talvez dependa de assemblies ausentes ou pacotes NuGet, ou tenha como alvo uma versão diferente do .NET. Nesses casos, você pode ser capaz de corrigir facilmente a compilação.

Adicionar referências

Para construir corretamente, o código deve estar correto e ter as referências corretas a bibliotecas ou outras dependências. Sublinhados ondulados vermelhos no código ou entradas na Lista de Erros mostram erros mesmo antes de compilar e executar o programa. Se os erros estiverem relacionados a nomes não resolvidos, você provavelmente precisará adicionar uma referência ou uma diretiva using, ou ambos. Se o código fizer referência a quaisquer assemblies ou pacotes NuGet ausentes, você precisará adicionar essas referências ao projeto.

O Visual Studio tenta ajudá-lo a identificar referências ausentes. Quando um nome não é resolvido, um ícone de lâmpada aparece no editor. Selecione a lâmpada para ver sugestões sobre como corrigir o problema. As correções podem ser:

• Adicione uma diretiva de uso.
• Adicione uma referência a um assembly.
• Instale um pacote NuGet.

Adicionar uma diretiva de uso

Eis um exemplo de uma diretiva using em falta. Você pode adicionar using System; ao início do arquivo de código para resolver o nome não resolvido Console:

Mais recentemente, o C# suporta diretivas de utilização implícitas para alguns namespaces comumente usados. Portanto, se tiver escolhido essa opção ao criar um projeto, não precisará delas.

Adicionar uma referência de assembly

As referências .NET podem ser assemblies ou pacotes NuGet. No código-fonte, o editor ou autor geralmente explica quais assemblies o código requer e de quais pacotes ele depende. Para adicionar uma referência a um projeto manualmente, clique com o botão direito do mouse no nó Referências no Gerenciador de Soluções e escolha Adicionar Referência. No Gestor de Referências, localize e adicione o assembly necessário.

Você pode encontrar assemblies e adicionar referências seguindo as instruções em Adicionar ou remover referências usando o Gerenciador de Referências.

Adicionar um pacote NuGet

Se o Visual Studio detetar um pacote NuGet ausente, uma lâmpada aparecerá e lhe dará a opção de instalar o pacote:

Se isso não resolver o problema ou o Visual Studio não conseguir localizar o pacote, tente procurar o pacote online. Veja Instalar e usar um pacote NuGet no Visual Studio.

Use a versão correta do .NET

Como diferentes versões do .NET Framework têm alguma compatibilidade com versões anteriores, uma estrutura mais recente pode executar código escrito para uma estrutura mais antiga sem alterações. Mas às vezes você precisa direcionar uma versão específica do .NET Framework. Talvez seja necessário instalar uma versão específica do .NET Framework ou .NET Core. Veja Modificar o Visual Studio.

Para alterar a versão de destino do .NET Framework, consulte Alterar a estrutura de destino. Para obter mais informações, consulte Solucionando problemas de erros de direcionamento do .NET Framework.

Próximos passos

• Explore o ambiente de desenvolvimento do Visual Studio lendo Bem-vindo ao IDE do Visual Studio.
• Crie seu primeiro aplicativo C#.