Tutorial: Criar um aplicativo de console .NET usando o Visual Studio Code

Este tutorial mostra como criar e executar um aplicativo de console .NET usando o Visual Studio Code e a CLI do .NET. As tarefas do projeto, como criar, compilar e executar um projeto, são feitas usando a CLI do .NET. Você pode seguir este tutorial com um editor de código diferente e executar comandos em um terminal, se preferir.

Pré-requisitos

• Visual Studio Code com a extensão C# instalada.

  Se você tiver a extensão C# Dev Kit instalada, desinstale-a ou desative-a. Ele não é usado por esta série de tutoriais.

  Para obter informações sobre como instalar extensões no Visual Studio Code, consulte VS Code Extension Marketplace.

• O SDK do .NET 8.

Criar a aplicação

Crie um projeto de aplicativo de console .NET chamado "HelloWorld".

1. Inicie o Visual Studio Code.

2. Selecione File Open Folder (File>>Open... no macOS) no menu principal.

3. Na caixa de diálogo Abrir pasta, crie uma pasta HelloWorld e selecione-a. Em seguida, clique em Selecionar pasta (Abrir no macOS).

   O nome da pasta torna-se o nome do projeto e o nome do namespace por padrão. Você adicionará código posteriormente no tutorial que assume que o namespace do projeto é HelloWorld.

4. Na caixa de diálogo Você confia nos autores dos arquivos nesta pasta?, selecione Sim, confio nos autores. Você pode confiar nos autores porque essa pasta só tem arquivos gerados pelo .NET e adicionados ou modificados por você.

5. Abra o Terminal no Visual Studio Code selecionando Exibir>Terminal no menu principal.

   O Terminal abre com o prompt de comando na pasta HelloWorld .

6. No Terminal, digite o seguinte comando:

   dotnet new console --framework net8.0 --use-program-main
   

   Abra o arquivo Program.cs para ver o aplicativo simples criado pelo modelo:

   namespace HelloWorld;
   
   class Program
   {
       static void Main(string[] args)
       {
           Console.WriteLine("Hello, World!");
       }
   }
   

   Na primeira vez que você abre um arquivo .cs , o Visual Studio Code solicita que você adicione ativos para criar e depurar seu aplicativo. Selecione Sim e o Visual Studio Code cria uma pasta .vscode com arquivos launch.json e tasks.json.

   Nota

   Se você não receber o prompt, ou se acidentalmente descartá-lo sem selecionar Sim, execute as seguintes etapas para criar launch.json e tasks.json:

   • Selecione Executar>Adicionar configuração no menu.
   • Selecione .NET 5+ e .NET Core no prompt Selecionar ambiente .

   O código define uma classe, , com um único método, , ProgramMainque usa uma String matriz como um argumento. Main é o ponto de entrada do aplicativo, o método que é chamado automaticamente pelo tempo de execução quando ele inicia o aplicativo. Todos os argumentos de linha de comando fornecidos quando o aplicativo é iniciado estão disponíveis na matriz args . O código em Main chama o Console.WriteLine(String) método para exibir uma mensagem na janela do console.

   C# tem um recurso chamado instruções de nível superior que permite omitir a Program classe e o Main método. Este tutorial não usa esse recurso. Se você usá-lo em seus programas é uma questão de preferência de estilo. dotnet new No comando que criou o projeto, a --use-program-main opção impediu que instruções de nível superior fossem usadas.

Executar a aplicação

Execute o seguinte comando no Terminal:

dotnet run

O programa exibe "Olá, Mundo!" e termina.

Melhorar a aplicação

Aprimore o aplicativo para solicitar ao usuário seu nome e exibi-lo junto com a data e a hora.

1. Programa aberto .cs.

2. Substitua o Main conteúdo do método em Program.cs, que é a linha que chama Console.WriteLine, com o seguinte código:

   Console.WriteLine("What is your name?");
   var name = Console.ReadLine();
   var currentDate = DateTime.Now;
   Console.WriteLine($"{Environment.NewLine}Hello, {name}, on {currentDate:d} at {currentDate:t}!");
   Console.Write($"{Environment.NewLine}Press any key to exit...");
   Console.ReadKey(true);
   

   Esse código exibe um prompt na janela do console e aguarda até que o usuário insira uma cadeia de caracteres seguida pela tecla Enter . Ele armazena essa cadeia de caracteres em uma variável chamada name. Ele também recupera o valor da propriedade, que contém a hora local atual, e o DateTime.Now atribui a uma variável chamada currentDate. E exibe esses valores na janela do console. Finalmente, ele exibe um prompt na janela do console e chama o método para aguardar a entrada do Console.ReadKey(Boolean) usuário.

   NewLine é uma maneira independente de plataforma e idioma para representar uma quebra de linha. É o mesmo que \n em C#.

   O cifrão ($) na frente de uma cadeia de caracteres permite colocar expressões como nomes de variáveis em chaves na cadeia de caracteres. O valor da expressão é inserido na cadeia de caracteres no lugar da expressão. Esta sintaxe é conhecida como cadeias de caracteres interpoladas.

3. Guardar as suas alterações.

   Importante

   No Visual Studio Code, você precisa salvar explicitamente as alterações. Ao contrário do Visual Studio, as alterações de arquivo não são salvas automaticamente quando você cria e executa um aplicativo.

4. Execute o programa novamente:

   dotnet run
   

5. Responda ao prompt digitando um nome e pressionando a tecla Enter .

   

6. Pressione qualquer tecla para sair do programa.

Recursos adicionais

• Configurando o Visual Studio Code

Próximos passos

Neste tutorial, você criou um aplicativo de console .NET. No próximo tutorial, você depurar o aplicativo.

Depurar um aplicativo de console .NET usando o Visual Studio Code

Este tutorial mostra como criar e executar um aplicativo de console .NET usando o Visual Studio Code e a CLI do .NET. As tarefas do projeto, como criar, compilar e executar um projeto, são feitas usando a CLI do .NET. Você pode seguir este tutorial com um editor de código diferente e executar comandos em um terminal, se preferir.

Pré-requisitos

• Visual Studio Code com a extensão C# instalada. Para obter informações sobre como instalar extensões no Visual Studio Code, consulte VS Code Extension Marketplace.
• O SDK do .NET 7.

Criar a aplicação

Crie um projeto de aplicativo de console .NET chamado "HelloWorld".

1. Inicie o Visual Studio Code.

2. Selecione File Open Folder (File>>Open... no macOS) no menu principal.

3. Na caixa de diálogo Abrir pasta, crie uma pasta HelloWorld e selecione-a. Em seguida, clique em Selecionar pasta (Abrir no macOS).

   O nome da pasta torna-se o nome do projeto e o nome do namespace por padrão. Você adicionará código posteriormente no tutorial que assume que o namespace do projeto é HelloWorld.

4. Na caixa de diálogo Você confia nos autores dos arquivos nesta pasta?, selecione Sim, confio nos autores. Você pode confiar nos autores porque essa pasta só tem arquivos gerados pelo .NET e adicionados ou modificados por você.

5. Abra o Terminal no Visual Studio Code selecionando Exibir>Terminal no menu principal.

   O Terminal abre com o prompt de comando na pasta HelloWorld .

6. No Terminal, digite o seguinte comando:

   dotnet new console --framework net7.0
   

   O modelo de projeto cria um aplicativo simples que exibe "Hello, World" na janela do console chamando o Console.WriteLine(String) método em Program.cs.

   Console.WriteLine("Hello, World!");
   

7. Substitua o conteúdo de Program.cs pelo seguinte código:

   namespace HelloWorld
   {
       class Program
       {
           static void Main(string[] args)
           {
               Console.WriteLine("Hello, World!");
           }
       }
   }
   

   Na primeira vez que você edita um arquivo .cs , o Visual Studio Code solicita que você adicione os ativos ausentes para criar e depurar seu aplicativo. Selecione Sim e o Visual Studio Code cria uma pasta .vscode com arquivos launch.json e tasks.json.

   Nota

   Se você não receber o prompt, ou se acidentalmente descartá-lo sem selecionar Sim, execute as seguintes etapas para criar launch.json e tasks.json:

   • Selecione Executar>Adicionar configuração no menu.
   • Selecione .NET 5+ e .NET Core no prompt Selecionar ambiente .

   O código define uma classe, , com um único método, , ProgramMainque usa uma String matriz como um argumento. Main é o ponto de entrada do aplicativo, o método que é chamado automaticamente pelo tempo de execução quando ele inicia o aplicativo. Todos os argumentos de linha de comando fornecidos quando o aplicativo é iniciado estão disponíveis na matriz args .

   Na versão mais recente do C#, um novo recurso chamado instruções de nível superior permite omitir a Program classe e o Main método. A maioria dos programas C# existentes não usa instruções de nível superior, portanto, este tutorial não usa esse novo recurso. Mas ele está disponível em C# 10, e se você usá-lo em seus programas é uma questão de preferência de estilo.

Executar a aplicação

Execute o seguinte comando no Terminal:

dotnet run

O programa exibe "Olá, Mundo!" e termina.

Melhorar a aplicação

Aprimore o aplicativo para solicitar ao usuário seu nome e exibi-lo junto com a data e a hora.

1. Programa aberto .cs.

2. Substitua o Main conteúdo do método em Program.cs, que é a linha que chama Console.WriteLine, com o seguinte código:

   Console.WriteLine("What is your name?");
   var name = Console.ReadLine();
   var currentDate = DateTime.Now;
   Console.WriteLine($"{Environment.NewLine}Hello, {name}, on {currentDate:d} at {currentDate:t}!");
   Console.Write($"{Environment.NewLine}Press any key to exit...");
   Console.ReadKey(true);
   

   Esse código exibe um prompt na janela do console e aguarda até que o usuário insira uma cadeia de caracteres seguida pela tecla Enter . Ele armazena essa cadeia de caracteres em uma variável chamada name. Ele também recupera o valor da propriedade, que contém a hora local atual, e o DateTime.Now atribui a uma variável chamada currentDate. E exibe esses valores na janela do console. Finalmente, ele exibe um prompt na janela do console e chama o método para aguardar a entrada do Console.ReadKey(Boolean) usuário.

   NewLine é uma maneira independente de plataforma e idioma para representar uma quebra de linha. As alternativas estão \n em C# e vbCrLf em Visual Basic.

   O cifrão ($) na frente de uma cadeia de caracteres permite colocar expressões como nomes de variáveis em chaves na cadeia de caracteres. O valor da expressão é inserido na cadeia de caracteres no lugar da expressão. Esta sintaxe é conhecida como cadeias de caracteres interpoladas.

3. Guardar as suas alterações.

   Importante

   No Visual Studio Code, você precisa salvar explicitamente as alterações. Ao contrário do Visual Studio, as alterações de arquivo não são salvas automaticamente quando você cria e executa um aplicativo.

4. Execute o programa novamente:

   dotnet run
   

5. Responda ao prompt digitando um nome e pressionando a tecla Enter .

   

6. Pressione qualquer tecla para sair do programa.

Recursos adicionais

• Configurando o Visual Studio Code

Próximos passos

Neste tutorial, você criou um aplicativo de console .NET. No próximo tutorial, você depurar o aplicativo.

Depurar um aplicativo de console .NET usando o Visual Studio Code

Este tutorial mostra como criar e executar um aplicativo de console .NET usando o Visual Studio Code e a CLI do .NET. As tarefas do projeto, como criar, compilar e executar um projeto, são feitas usando a CLI do .NET. Você pode seguir este tutorial com um editor de código diferente e executar comandos em um terminal, se preferir.

Pré-requisitos

• Visual Studio Code com a extensão C# instalada. Para obter informações sobre como instalar extensões no Visual Studio Code, consulte VS Code Extension Marketplace.
• O SDK do .NET 6.

Criar a aplicação

Crie um projeto de aplicativo de console .NET chamado "HelloWorld".

1. Inicie o Visual Studio Code.

2. Selecione File Open Folder (File>>Open... no macOS) no menu principal.

3. Na caixa de diálogo Abrir pasta, crie uma pasta HelloWorld e selecione-a. Em seguida, clique em Selecionar pasta (Abrir no macOS).

   O nome da pasta torna-se o nome do projeto e o nome do namespace por padrão. Você adicionará código posteriormente no tutorial que assume que o namespace do projeto é HelloWorld.

4. Na caixa de diálogo Você confia nos autores dos arquivos nesta pasta?, selecione Sim, confio nos autores. Você pode confiar nos autores porque essa pasta só tem arquivos gerados pelo .NET e adicionados ou modificados por você.

5. Abra o Terminal no Visual Studio Code selecionando Exibir>Terminal no menu principal.

   O Terminal abre com o prompt de comando na pasta HelloWorld .

6. No Terminal, digite o seguinte comando:

   dotnet new console --framework net6.0 --use-program-main
   

   O modelo de projeto cria um aplicativo simples que exibe "Hello, World" na janela do console chamando o Console.WriteLine(String) método em Program.cs.

   namespace HelloWorld;
   
   class Program
   {
       static void Main(string[] args)
       {
           Console.WriteLine("Hello, World!");
       }
   }
   

   Na primeira vez que você edita um arquivo .cs , o Visual Studio Code solicita que você adicione os ativos ausentes para criar e depurar seu aplicativo. Selecione Sim e o Visual Studio Code cria uma pasta .vscode com arquivos launch.json e tasks.json.

   Nota

   Se você não receber o prompt, ou se acidentalmente descartá-lo sem selecionar Sim, execute as seguintes etapas para criar launch.json e tasks.json:

   • Selecione Executar>Adicionar configuração no menu.
   • Selecione .NET 5+ e .NET Core no prompt Selecionar ambiente .

   O código define uma classe, , com um único método, , ProgramMainque usa uma String matriz como um argumento. Main é o ponto de entrada do aplicativo, o método que é chamado automaticamente pelo tempo de execução quando ele inicia o aplicativo. Todos os argumentos de linha de comando fornecidos quando o aplicativo é iniciado estão disponíveis na matriz args .

   Na versão mais recente do C#, um novo recurso chamado instruções de nível superior permite omitir a Program classe e o Main método. A maioria dos programas C# existentes não usa instruções de nível superior, portanto, este tutorial não usa esse novo recurso. Mas ele está disponível em C# 10, e se você usá-lo em seus programas é uma questão de preferência de estilo. dotnet new No comando que você usou para criar o projeto, a --use-program-main opção impediu que instruções de nível superior fossem usadas.

Executar a aplicação

Execute o seguinte comando no Terminal:

dotnet run

O programa exibe "Olá, Mundo!" e termina.

Melhorar a aplicação

Aprimore o aplicativo para solicitar ao usuário seu nome e exibi-lo junto com a data e a hora.

1. Programa aberto .cs.

2. Substitua o Main conteúdo do método em Program.cs, que é a linha que chama Console.WriteLine, com o seguinte código:

   Console.WriteLine("What is your name?");
   var name = Console.ReadLine();
   var currentDate = DateTime.Now;
   Console.WriteLine($"{Environment.NewLine}Hello, {name}, on {currentDate:d} at {currentDate:t}!");
   Console.Write($"{Environment.NewLine}Press any key to exit...");
   Console.ReadKey(true);
   

   Esse código exibe um prompt na janela do console e aguarda até que o usuário insira uma cadeia de caracteres seguida pela tecla Enter . Ele armazena essa cadeia de caracteres em uma variável chamada name. Ele também recupera o valor da propriedade, que contém a hora local atual, e o DateTime.Now atribui a uma variável chamada currentDate. E exibe esses valores na janela do console. Finalmente, ele exibe um prompt na janela do console e chama o método para aguardar a entrada do Console.ReadKey(Boolean) usuário.

   NewLine é uma maneira independente de plataforma e idioma para representar uma quebra de linha. As alternativas estão \n em C# e vbCrLf em Visual Basic.

   O cifrão ($) na frente de uma cadeia de caracteres permite colocar expressões como nomes de variáveis em chaves na cadeia de caracteres. O valor da expressão é inserido na cadeia de caracteres no lugar da expressão. Esta sintaxe é conhecida como cadeias de caracteres interpoladas.

3. Guardar as suas alterações.

   Importante

   No Visual Studio Code, você precisa salvar explicitamente as alterações. Ao contrário do Visual Studio, as alterações de arquivo não são salvas automaticamente quando você cria e executa um aplicativo.

4. Execute o programa novamente:

   dotnet run
   

5. Responda ao prompt digitando um nome e pressionando a tecla Enter .

   

6. Pressione qualquer tecla para sair do programa.

Recursos adicionais

• Configurando o Visual Studio Code

Próximos passos

Neste tutorial, você criou um aplicativo de console .NET. No próximo tutorial, você depurar o aplicativo.

Depurar um aplicativo de console .NET usando o Visual Studio Code