Execute um programa ou aplicação em C# no Visual Studio

Como executar um programa ou iniciar uma aplicação depende daquilo de que parte, do tipo de programa ou aplicação, e se quer executar no depurador. No caso mais simples, construir e executar um projeto aberto no Visual Studio:

• Prima F5, selecione Depurar>Iniciar com depuração no menu do Visual Studio, ou selecione a seta verde de Início e o nome do projeto na barra de ferramentas do Visual Studio.
• Ou, para executar sem depuração, pressionar Ctrl+F5 ou escolher Debug>Start sem depurar no menu do Visual Studio.

Comece por um projeto

Podes executar um projeto C# (.csproj ficheiro) se for um programa executável. Se o projeto contiver um ficheiro C# com um Main método, e a sua saída for um executável ou .exe ficheiro, provavelmente irá correr se for compilado com sucesso. Se a saída do teu projeto for um ficheiro executável e não tiver método Main , a execução do programa começa com instruções de topo. Ver Programas sem métodos principais. Alguns tipos de projetos, como bibliotecas de classes, não são executáveis. As bibliotecas de classes não são executáveis isoladamente, mas podem ser referenciadas por outros projetos.

Se não tiveres a certeza se o projeto que tens é um ficheiro executável, seleciona o nó do projeto no Explorador de Soluções e abre as propriedades do projeto. Ou clica com o botão direito no nó para abrir o menu de contexto e escolhe Propriedades, ou carrega em Alt+Enter. Na secção Aplicação, procure o tipo de saída. Se for uma Aplicação de Consola, então é um programa executável.

1. Abra o projeto. Para isso, pode fazer duplo clique ou tocar no .csproj ficheiro no Explorador de Ficheiros do Windows, ou escolher Abrir um projeto no Visual Studio, navegar para encontrar o .csproj ficheiro e selecionar o ficheiro.

2. Depois de o projeto carregar no Visual Studio, se a sua solução Visual Studio tiver mais do que um projeto, certifique-se de definir o projeto com o Main método como projeto inicial. Para definir o projeto de arranque, clique com o botão direito no nome do projeto ou nó no Explorador de Soluções e escolha Definir como Projeto de Arranque no menu contextual.

   

3. Para executar o programa, pressiona Ctrl+F5, seleciona Debug>Start sem depurar no menu superior, ou seleciona o botão verde Start .

   O Visual Studio tenta construir e executar o seu projeto. No fundo do ecrã do Visual Studio, a saída da compilação aparece na janela de Saída , e quaisquer erros de compilação aparecem na janela da Lista de Erros .

   Se a build for bem-sucedida, a aplicação corre conforme o tipo de projeto. As aplicações de consola correm numa janela de terminal, as aplicações de ambiente de trabalho do Windows começam numa nova janela de ambiente de trabalho e as aplicações web correm num navegador alojado pelo IIS Express.

Comece pelo código

Se tiveres em mente um exemplo de código C# executável, como este, ou um ficheiro ou ficheiros de código C# executáveis no disco, segue estes passos.

Primeiro, certifique-se de que o código é um programa executável de uma fonte confiável. Qualquer aplicação com um Main método é provavelmente um programa executável, mas com a versão atual do C#, programas sem Main métodos com instruções de topo também podem ser executadas. Podes usar o modelo da Consola para criar um projeto no Visual Studio e depois copiar o código para ele.

Um único ficheiro de código

1. Inicia o Visual Studio, escolhe Criar um novo projeto e escolhe o projeto C# Console App .
2. Substitui todo o código do ficheiro do projeto .cs pelo conteúdo do teu código ou ficheiro. Se o código que queres usar estiver na web ou num único ficheiro, pode ser mais fácil selecionar o código, copiá-lo para a prancheta e colá-lo num ficheiro de código no projeto Visual Studio.
3. Renomeia o ficheiro do projeto .cs para corresponder ao nome do teu ficheiro de código.

Vários ficheiros de código no disco

1. Inicia o Visual Studio e cria um novo projeto do tipo apropriado. Usa a aplicação de consola C# se não tiveres a certeza.
2. No novo projeto, substitui todo o código do ficheiro de código do projeto pelo conteúdo da tua primeira lista de código ou ficheiro.
3. Renomeie o ficheiro de código do projeto para corresponder ao nome do seu ficheiro de código.
4. Para cada ficheiro de código restante:
   1. Clique com o botão direito no nó do projeto no Explorador de Soluções e escolha Adicionar>Item Existente, ou selecione o projeto e pressione Shift+Alt+A.
   2. Navegue e selecione o ficheiro de código para o importar para o projeto.

Vários ficheiros numa pasta

Se tiver uma pasta com muitos ficheiros, verifique primeiro se há um ficheiro de projeto ou solução. Os programas criados pelo Visual Studio têm ficheiros de projeto e solução. No Explorador de Ficheiros do Windows, procure ficheiros com a .csproj extensão ou .sln . Clique duas vezes no .csproj ficheiro para o abrir no Visual Studio. Veja Começar a partir de uma solução ou projeto Visual Studio.

Se o código for de outro ambiente de desenvolvimento, não há ficheiro de projeto. Abra a pasta escolhendo Abrir>Pasta no Visual Studio. Veja Desenvolver código sem projetos ou soluções.

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

Se o código que queres executar estiver num repositório GitHub ou Azure DevOps, podes usar o Visual Studio para abrir o projeto diretamente a partir do repositório. Veja Abrir um projeto a partir de um repositório.

Execute o programa

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

O Visual Studio tenta construir e executar o código no teu projeto. Se uma build não tiver sucesso, consulte as secções seguintes para algumas ideias sobre como fazer o projeto funcionar com sucesso.

Solução de problemas

O teu código pode ter erros. Ou o código pode estar correto, mas talvez dependa da falta de assemblies ou pacotes NuGet, ou seja direcionado a uma versão diferente do .NET. Nesses casos, pode ser que consiga facilmente corrigir a build.

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 vermelhos ondulados no código ou entradas na Lista de Erros indicam erros mesmo antes de compilar e executar o programa. Se os erros estiverem relacionados com nomes não resolvidos, terá provavelmente de adicionar uma referência ou uma using diretiva, ou as duas. Se o código fizer referência a assemblies ou pacotes NuGet em falta, precisa de adicionar essas referências ao projeto.

O Visual Studio tenta ajudar-te a identificar referências em falta. Quando um nome não está resolvido, aparece um ícone de lâmpada no editor. Selecione a lâmpada para ver sugestões sobre como resolver o problema. As soluções podem ser:

• Adicione uma diretiva de uso.
• Adicione uma referência a uma assembleia.
• Instala um pacote NuGet.

Adicionar uma diretiva de utilização

Aqui está um exemplo de uma diretiva using em falta. Pode adicionar using System; ao início do ficheiro de código para resolver o nome Consolenão resolvido:

Mais recente, C# suporta o uso implícito de diretivas para alguns namespaces comuns, por isso, se escolheres essa opção ao criar um projeto, não precisas deles.

Adicionar uma referência de montagem

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

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

Adicionar um pacote NuGet

Se o Visual Studio detetar um pacote NuGet em falta, surge uma lâmpada e dá-lhe a opção de instalar o pacote:

Se isso não resolver o problema ou se o Visual Studio não conseguir localizar o pacote, tente procurá-lo 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 retroativa, um framework mais recente pode correr código escrito para um framework mais antigo sem quaisquer alterações. Mas por vezes é preciso direcionar uma versão específica do .NET Framework. Pode precisar de instalar uma versão específica do .NET Framework ou do .NET Core. Consulte Modificar o Visual Studio.

Para alterar a versão de destino do .NET Framework, veja Alterar o framework de destino. Para mais informações, consulte Resolução de Problemas do .NET Framework relativos a erros de direcionamento.

Próximos passos

• Explore o ambiente de desenvolvimento do Visual Studio lendo Bem-vindo ao IDE do Visual Studio.
• Crie a sua primeira aplicação C#.