Para criar o seu primeiro aplicativo do .NET, você precisará instalar o SDK do .NET, o Visual Studio Code e o Kit de Desenvolvimento em C#.
O SDK (Software Development Kit) do .NET é uma coleção gratuita e de software livre de ferramentas e bibliotecas que você precisará para criar e executar aplicativos usando C#. C# é a linguagem de programação moderna orientada a objeto que você usará para este tutorial.
O Visual Studio Code (VS Code) é o editor de código leve, gratuito e de software livre mais popular do mundo. É aqui que você escreverá o seu código em C#.
O Kit de Desenvolvimento em C# é um conjunto avançado de extensões do VS Code que facilita o desenvolvimento em C#. Ele ajuda você a escrever, testar e depurar o seu código à medida que você cria aplicativos.
O arquivo de Configuração do Winget do .NET instalará o SDK do .NET 8, o VS Code e o Kit de Desenvolvimento do C# para você. Se você já tiver algo instalado, o Winget ignorará essa etapa de instalação.
Para criar seu primeiro aplicativo .NET com o Visual Studio Code, configure seu ambiente:
Abra o VS Code e selecione o botão Extensões na Barra de Atividades do VS Code à esquerda. Digite C# na barra de pesquisa, selecione Kit de Desenvolvimento em C# e, em seguida, selecione o botão Instalar na página de extensão do Kit de Desenvolvimento C#.
Depois de clicar duas vezes no arquivo, um terminal será aberto e você verá que o arquivo de Configuração do Winget está pronto para instalar o SDK do .NET 8, VS Code se você não o tiver, e o Kit de Desenvolvimento C#.
Leia o contrato de licença e concorde com ele digitando "y" no terminal e pressionando Enter.
Observação: você é responsável por entender as definições de configuração que você está escolhendo executar. A Microsoft não é responsável pelo arquivo de configuração que você criou ou importou. Esta configuração pode alterar as configurações no Windows, instalar software, alterar configurações de software (incluindo configurações de segurança) e aceitar contratos de usuário para pacotes e serviços de terceiros em seu nome. Ao executar este arquivo de configuração, você reconhece que entende e concorda com esses recursos e configurações. Todos os aplicativos instalados são licenciados para você por seus proprietários. A Microsoft não é responsável nem concede licenças a pacotes ou serviços de terceiros.
O Winget agora está instalando tudo o que você precisa para começar! Isso deve levar cerca de 5 minutos para ser concluído e, quando terminar, você verá a saída abaixo no terminal.
Depois de clicar duas vezes no arquivo, a Home page de Desenvolvimento será aberta e você verá que o arquivo de Configuração do Winget está pronto para instalar o SDK do .NET 8, VS Code se você não o tiver, e o Kit de Desenvolvimento C#.
Leia o contrato de licença e concorde com ele clicando em "Concordo e quero continuar" no canto inferior esquerdo e, em seguida, clicando em "Configurar como administrador" no canto inferior direito. Selecione "Sim" quando for perguntado se você deseja permitir que a Página Inicial de Desenvolvimento faça alterações em seu dispositivo.
Observação: você é responsável por entender as definições de configuração que você está escolhendo executar. A Microsoft não é responsável pelo arquivo de configuração que você criou ou importou. Esta configuração pode alterar as configurações no Windows, instalar software, alterar configurações de software (incluindo configurações de segurança) e aceitar contratos de usuário para pacotes e serviços de terceiros em seu nome. Ao executar este arquivo de configuração, você reconhece que entende e concorda com esses recursos e configurações. Todos os aplicativos instalados são licenciados para você por seus proprietários. A Microsoft não é responsável nem concede licenças a pacotes ou serviços de terceiros.
A Home page de Desenvolvimento agora está instalando tudo o que você precisa para começar! A conclusão deve levar cerca de 5 minutos e, quando terminar, você verá a saída abaixo na janela.
Verifique se tudo foi instalado corretamente
Agora que o seu ambiente está configurado, vá para Arquivar na Barra de Tarefas do Windows e digite Visual Studio Code. Clique no aplicativo para abrir o VS Code.
Depois de configurar seu ambiente, abra um novo terminal do VS Code. Na barra de ferramentas, selecione Terminal e, em seguida, Novo Terminal.
Observação: observe que, se você abrir o VS Code por meio de um terminal, será necessário habilitar a Confiança do Workspace.
Agora, abra um novo terminal acessando a barra de ferramentas e selecionando Terminal e Novo Terminal.
No terminal, execute o comando a seguir para verificar sua instalação.
Terminal
dotnet
Se a instalação for bem-sucedida, você deverá ver uma saída semelhante à seguinte:
Terminal
Usage: dotnet [options]Usage: dotnet [path-to-application]Options:-h|--help Display help.--info Display .NET information.--list-sdks Display the installed SDKs.--list-runtimes Display the installed runtimes.path-to-application:The path to an application .dll file to execute.
Se tudo estiver certo, selecione o botão Continuar abaixo para ir para a próxima etapa.
Encontrou um erro?
Se você receber um erro o "dotnet" não é reconhecido como um comando interno ou externo, verifique se você abriu um novo terminal do VS Code. Se a reinicialização do VS Code ou a reinicialização do computador não resolver o problema, use o botão Encontrei um problema para obter ajuda para corrigir o problema.
Criar seu aplicativo
Abra a paleta de comandos no VS Code pressionando CTRL+SHIFT+P.
Abra a paleta de comandos no VS Code pressionando CMD+SHIFT+P.
Digite .NET: para ver os comandos que você pode executar com o Kit de Desenvolvimento em C#.
Localize e selecione .NET: Novo Projeto para criar um novo projeto .NET.
Role para baixo e selecione Aplicativo de Console.
Escolha o local da pasta em que você deseja salvar seu projeto.
Nomeie o projeto MyConsoleApp na paleta de comandos quando solicitado.
Habilite a Confiança do Workspace marcando a caixa e selecionando Sim, eu confio nos autores.
Se você tiver uma Assinatura do Visual Studio, entre em sua conta. Se você não vir um prompt pop-up, clique no ícone C# na Barra de Status do VS Code na parte inferior direita da janela.
Na Barra Lateral, certifique-se de que o VS Code Explorer esteja aberto. Aqui você verá a pasta MyConsoleApp e o Gerenciador de Soluções.Acompanhe o vídeo abaixo para: colapsar a pasta MyConsoleApp, abrir o Gerenciador de Soluções, abrir o projeto MyConsoleApp e arrastar e soltar o Gerenciador de Soluções mais para cima.
Recolha a pasta MyConsoleApp no VS Code Explorer.
Clique na divisa à esquerda do Gerenciador de Soluções para expandi-lo.
Clique na divisa à esquerda do projeto MyConsoleApp no Gerenciador de Soluções para expandi-lo.
Arraste e solte o Gerenciador de Soluções abaixo de MyConsoleApp.
O arquivo principal na pasta MyConsoleApp é chamado de Program.cs. Por padrão, ele já contém o código necessário para gravar Hello, World! no terminal. Clique no arquivo para ver o código criado pelo modelo:
Selecione o botão Continuar abaixo para ir para a próxima etapa.
Encontrou um erro?
Se o problema não for resolvido, selecione o botão Ocorreu um problema abaixo para obter ajuda para corrigir o problema.
Executar seu aplicativo
Para executar seu aplicativo, selecione o menu suspenso à direita do botão executar no canto superior direito e selecione Executar projeto associado a esse arquivo.
Você deve ver Hello, World! em seu terminal do VS Code.
Terminal
Hello, World!
Parabéns, você criou e executou seu primeiro aplicativo .NET. Selecione o botão Continuar abaixo para ir para a próxima etapa.
Editar seu código
No arquivo Program.cs, adicione a linha realçada após o código que imprime Hello, World!, da seguinte maneira:
Program.cs
// See https://aka.ms/new-console-template for more informationConsole.WriteLine("Hello, World!");Console.WriteLine("The current time is " + DateTime.Now);
Salve o arquivo Program.cs e selecione Executar projeto associado ao arquivo novamente. Se você tiver sucesso, deverá ver uma saída semelhante à seguinte:
Terminal
Hello, World!
The current time is 21/12/2024 13:18:28
Próximas etapas
Parabéns, você criou e executou seu primeiro aplicativo .NET!
Continuar aprendendo
Para continuar aprendendo as habilidades gerais do .NET, experimente nossos tutoriais no Microsoft Learn onde você aprenderá sobre o .NET, dependências, trabalhar com arquivos, depuração e muito mais:
C# é a linguagem de programação moderna, inovadora e de código aberto do .NET para compilar todos os seus aplicativos. Introdução ao testar nossos tutoriais do C# interativo no Microsoft Learn:
