Building console apps using VS Code

The goal of this section is to showcase how to build a console app using VS Code and the dotnet CLI.

If you never want to try VS Code or the dotnet command-line tool, then please feel free to skip this section, and then continue with the Making good use of the GitHub repository for this book section.

Both the instructions and screenshots in this section are for Windows, but the same actions will work with VS Code on the macOS and Linux variants.

The main differences will be native command-line actions such as deleting a file; both the command and the path are likely to be different on Windows, macOS, and Linux. Luckily, the dotnet CLI tool itself and its commands are identical on all platforms.

Writing code using VS Code

Let’s get started writing code!

1. Start your favorite tool for working with the filesystem, for example, File Explorer on Windows or Finder on Mac.
2. Navigate to your C: drive on Windows, your user folder on macOS or Linux (mine are named markjprice and home/markjprice), or any directory or drive in which you want to save your projects.
3. Create a new folder named cs13net9. (If you completed the section for Visual Studio, then this folder will already exist.)
4. In the cs13net9 folder, create a new folder named Chapter01-vscode.

5. In the Chapter01-vscode folder, open the command prompt or terminal. For example, on Windows, right-click on the folder and then select Open in Terminal.
6. At the command prompt or terminal, use the dotnet CLI to create a new solution named Chapter01, as shown in the following command:

   dotnet new sln --name Chapter01
   

7. Note the result, as shown in the following output:

   The template "Solution File" was created successfully.
   

8. At the command prompt or terminal, use the dotnet CLI to create a new subfolder and project for a console app named HelloCS, as shown in the following command:

   dotnet new console --output HelloCS
   

9. At the command prompt or terminal, use the dotnet CLI to add the project to the solution, as shown in the following command:

   dotnet sln add HelloCS
   

10. Note the results, as shown in the following output:

    Project `HelloCS\HelloCS.csproj` added to the solution.
    

11. At the command prompt or terminal, start VS Code and open the current folder, indicated with a . (dot), as shown in the following command:

    code .
    

12. If you are prompted with Do you trust the authors of the files in this folder?, select the Trust the authors of all files in the parent folder ‘cs13net9’ checkbox, and then click Yes, I trust the authors.
13. In VS Code, in EXPLORER, in the CHAPTER01-VSCODE folder view, expand the HelloCS folder, and you will see that the dotnet command-line tool created two files, HelloCS.csproj and Program.cs, and the bin and obj folders, as shown in Figure 1.9:

Figure 1.9: EXPLORER shows that two files and temporary folders have been created

14. Navigate to View | Output.
15. In the OUTPUT pane, select C# Dev Kit, and note that the tool has recognized and processed the solution.
16. At the bottom of EXPLORER, note SOLUTION EXPLORER.
17. Drag SOLUTION EXPLORER to the top of the EXPLORER pane and expand it.
18. In SOLUTION EXPLORER, expand the HelloCS project, and then click the file named Program.cs to open it in the editor window.
19. In Program.cs, modify line 2 so that the text that is being written to the console says Hello, C#!.

In the preceding steps, I showed you how to use the dotnet CLI to create solutions and projects. Finally, with the August 2024 or later releases of the C# Dev Kit, VS Code has an improved project creation experience that provides you access to the same options you can use when creating a new project through the dotnet CLI.

To enable this ability, you must change a setting, as shown in the following configuration:

"csharp.experimental.dotnetNewIntegration": true

In VS Code, navigate to File | Preferences | Settings, search for dotnet new, and then select the Csharp > Experimental: Dotnet New Integration checkbox.

You can learn more at the following link:

https://devblogs.microsoft.com/dotnet/whats-new-in-csharp-dev-kit-august-2024/#create-new-project-configuration-options

Compiling and running code using the dotnet CLI

The next task is to compile and run the code:

1. In SOLUTION EXPLORER, right-click on any file in the HelloCS project and choose Open In Integrated Terminal.
2. In TERMINAL, enter the following command: dotnet run.
3. The output in the TERMINAL window will show the result of running your application.
4. In Program.cs, after the statement that outputs the message, add statements to get the name of the namespace of the Program class, write it to the console, and then throw a new exception, as shown in the following code:

   string name = typeof(Program).Namespace ?? "<null>";
   Console.WriteLine($"Namespace: {name}");
   throw new Exception();
   

5. In TERMINAL, enter the following command: dotnet run.

6. The output in the TERMINAL window will show the result of running your application, including that a hidden Program class was defined by the compiler, with a method named <Main>$ that has a parameter named args to pass in arguments, and that it does not have a namespace, as shown in the following output:

   Hello, C#!
   Namespace: <null>
   Unhandled exception. System.Exception: Exception of type 'System.Exception' was thrown.
      at Program.<Main>$(String[] args) in C:\cs13net9\Chapter01-vscode\HelloCS\Program.cs:line 7
   

Adding a second project using VS Code

Let’s add a second project to explore how to work with multiple projects:

1. In TERMINAL, change to the Chapter01-vscode directory, as shown in the following command:

   cd ..
   

2. In TERMINAL, create a new console app project named AboutMyEnvironment, using the older non-top-level program style, as shown in the following command:

   dotnet new console -o AboutMyEnvironment --use-program-main
   

3. In TERMINAL, use the dotnet CLI to add the new project folder to the solution, as shown in the following command:

   dotnet sln add AboutMyEnvironment
   

4. Note the results, as shown in the following output:

   Project `AboutMyEnvironment\AboutMyEnvironment.csproj` added to the solution.
   

5. In SOLUTION EXPLORER, in the AboutMyEnvironment project, open Program.cs, and then in the Main method, change the existing statement to output the current directory, the operating system version string, and the namespace of the Program class, as shown in the following code:

   Console.WriteLine(Environment.CurrentDirectory);
   Console.WriteLine(Environment.OSVersion.VersionString);
   Console.WriteLine("Namespace: {0}",
     typeof(Program).Namespace ?? "<null>");
   

6. In SOLUTION EXPLORER, right-click on any file in the AboutMyEnvironment project and choose Open In Integrated Terminal.
7. In TERMINAL, enter the command to run the project, as shown in the following command: dotnet run.
8. Note the output in the TERMINAL window, as shown in the following output:

   C:\cs13net9\Chapter01-vscode\AboutMyEnvironment
   Microsoft Windows NT 10.0.26100.0
   Namespace: AboutMyEnvironment
   

If you were to run the program on macOS Ventura, the environment operating system would be different, as shown in the following output:

Unix 13.5.2

Summary of steps for VS Code

Follow these steps to create a solution and projects using VS Code, as shown in Table 1.5:

Table 1.5: Summary of steps to create a solution and projects using VS Code

Summary of other project types used in this book

A Console App / console project is just one type of project template. In this book, you will also create projects using the following project templates, as shown in Table 1.6:

Table 1.6: Project template names for various code editors

The steps for adding any type of new project to a solution are the same. Only the type name of the project template differs and, sometimes, some command-line switches to control options. I will always specify what those switches and options should be if they differ from the defaults.

A summary of project template defaults, options, and switches can be found here: https://github.com/markjprice/cs13net9/blob/main/docs/ch01-project-options.md.