Tutorial: criar um aplicativo de console .NET usando o Visual Studio CodeTutorial: Create a .NET console application using Visual Studio Code

Este tutorial mostra como criar e executar um aplicativo de console .NET usando Visual Studio Code e a CLI do .NET.This tutorial shows how to create and run a .NET console application by using Visual Studio Code and the .NET CLI. Tarefas de projeto, como criar, compilar e executar um projeto, são feitas usando a CLI do .NET.Project tasks, such as creating, compiling, and running a project are done by using the .NET CLI. Você pode seguir este tutorial com um editor de código diferente e executar comandos em um terminal, se preferir.You can follow this tutorial with a different code editor and run commands in a terminal if you prefer.

Pré-requisitosPrerequisites

  1. Visual Studio Code com a extensão C# instalada.Visual Studio Code with the C# extension installed. Para obter informações sobre como instalar extensões em Visual Studio Code, consulte vs Code Marketplace de extensão.For information about how to install extensions on Visual Studio Code, see VS Code Extension Marketplace.
  2. O SDK do .net 5,0 ou posteriorThe .NET 5.0 SDK or later

Criar o aplicativoCreate the app

Crie um projeto de aplicativo de console .NET chamado "HelloWorld".Create a .NET console app project named "HelloWorld".

  1. Inicie o Visual Studio Code.Start Visual Studio Code.

  2. Selecione arquivo > abrir pasta (arquivo > aberto... no MacOS) no menu principal.Select File > Open Folder (File > Open... on macOS) from the main menu.

  3. Na caixa de diálogo abrir pasta , crie uma pasta HelloWorld e clique em Selecionar pasta (aberta no MacOS).In the Open Folder dialog, create a HelloWorld folder and click Select Folder (Open on macOS).

    O nome da pasta torna-se o nome do projeto e o nome do namespace por padrão.The folder name becomes the project name and the namespace name by default. Você adicionará código posteriormente no tutorial que assume que o namespace do projeto é HelloWorld .You'll add code later in the tutorial that assumes the project namespace is HelloWorld.

  4. Abra o terminal no Visual Studio Code selecionando Exibir > terminal no menu principal.Open the Terminal in Visual Studio Code by selecting View > Terminal from the main menu.

    O terminal é aberto com o prompt de comando na pasta HelloWorld .The Terminal opens with the command prompt in the HelloWorld folder.

  5. No terminal, digite o seguinte comando:In the Terminal, enter the following command:

    dotnet new console
    

O modelo cria um simples aplicativo “Olá, Mundo”.The template creates a simple "Hello World" application. Ele chama o Console.WriteLine(String) método para exibir " Hello World! " na janela do console.It calls the Console.WriteLine(String) method to display "Hello World!" in the console window.

O código de modelo define uma classe, Program , com um único método, Main , que usa uma String matriz como um argumento:The template code defines a class, Program, with a single method, Main, that takes a String array as an argument:

using System;

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

Main é o ponto de entrada do aplicativo, o método que é chamado automaticamente pelo runtime quando ele inicia o aplicativo.Main is the application entry point, the method that's called automatically by the runtime when it launches the application. Quaisquer argumentos de linha de comando fornecidos quando o aplicativo for iniciado estão disponíveis na matriz args.Any command-line arguments supplied when the application is launched are available in the args array.

Executar o aplicativoRun the app

Execute o seguinte comando no terminal:Run the following command in the Terminal:

dotnet run

O programa exibe "Olá, Mundo!"The program displays "Hello World!" e termina.and ends.

O comando de execução dotnet

Aprimorar o aplicativoEnhance the app

Aprimore o aplicativo para solicitar ao usuário seu nome e exibi-lo junto com a data e hora.Enhance the application to prompt the user for their name and display it along with the date and time.

  1. Abra Program.cs clicando nele.Open Program.cs by clicking on it.

    Na primeira vez que um arquivo do C# é aberto no Visual Studio Code, o OmniSharp é carregado no editor.The first time you open a C# file in Visual Studio Code, OmniSharp loads in the editor.

    Abra o arquivo Program.cs

  2. Selecione Sim quando Visual Studio Code solicitar que você adicione os ativos ausentes para compilar e depurar seu aplicativo.Select Yes when Visual Studio Code prompts you to add the missing assets to build and debug your app.

    Prompt para ativos ausentes

  3. Substitua o conteúdo do Main método em Program.cs, que é a linha que chama Console.WriteLine , com o seguinte código:Replace the contents of the Main method in Program.cs, which is the line that calls Console.WriteLine, with the following code:

    Console.WriteLine("\nWhat is your name? ");
    var name = Console.ReadLine();
    var date = DateTime.Now;
    Console.WriteLine($"\nHello, {name}, on {date:d} at {date:t}!");
    Console.Write("\nPress 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 .This code displays a prompt in the console window and waits until the user enters a string followed by the Enter key. Ele armazena essa cadeia de caracteres em uma variável chamada name .It stores this string in a variable named name. Ele também recupera o valor da propriedade DateTime.Now, que contém a hora local atual e o atribui a uma variável chamada date.It also retrieves the value of the DateTime.Now property, which contains the current local time, and assigns it to a variable named date. E ele exibe esses valores na janela do console.And it displays these values in the console window. Por fim, ele exibe um prompt na janela do console e chama o Console.ReadKey(Boolean) método para aguardar a entrada do usuário.Finally, it displays a prompt in the console window and calls the Console.ReadKey(Boolean) method to wait for user input.

    O \n representa um caractere de nova linha.The \n represents a newline character.

    O cifrão ( $ ) na frente de uma cadeia de caracteres permite que você coloque expressões como nomes de variáveis entre chaves na cadeia de caracteres.The dollar sign ($) in front of a string lets you put expressions such as variable names in curly braces in the string. O valor da expressão é inserido na cadeia de caracteres no lugar da expressão.The expression value is inserted into the string in place of the expression. Essa sintaxe é conhecida como cadeias de caracteres interpoladas.This syntax is referred to as interpolated strings.

  4. Salve suas alterações.Save your changes.

    Importante

    No Visual Studio Code, você precisa salvar explicitamente as alterações.In Visual Studio Code, you have to explicitly save changes. Ao contrário do Visual Studio, as alterações de arquivo não são salvas automaticamente quando você compila e executa um aplicativo.Unlike Visual Studio, file changes are not automatically saved when you build and run an app.

  5. Execute o programa novamente:Run the program again:

    dotnet run
    
  6. Responda ao prompt digitando um nome e pressionando a tecla Enter .Respond to the prompt by entering a name and pressing the Enter key.

    Janela do terminal com saída do programa modificada

  7. Pressione qualquer tecla para encerrar o programa.Press any key to exit the program.

Recursos adicionaisAdditional resources

Próximas etapasNext steps

Neste tutorial, você criou um aplicativo de console .NET.In this tutorial, you created a .NET console application. No próximo tutorial, você depurará o aplicativo.In the next tutorial, you debug the app.