.NET - Your First .NET Application (Console App)

Your First .NET Application (Console App)

Creating your first .NET Console Application is a fundamental step toward mastering the .NET development ecosystem. A console app is one of the simplest types of applications you can build using .NET and is ideal for learning programming fundamentals, exploring the .NET CLI, and testing new features. In this guide, we’ll take you through a step-by-step tutorial to build, run, and understand your first .NET Console Application using C# and the .NET SDK.

What is a .NET Console Application?

A .NET Console Application is a lightweight program that runs in a terminal or command prompt window. It does not include any graphical user interface and is typically used for simple utilities, automation scripts, or educational purposes.

Console apps are ideal for:

• Learning C# or F# programming
• Running quick logic tests
• Creating background services or batch jobs
• Practicing algorithm development

Prerequisites to Create a .NET Console App

Before you begin, make sure you have the following tools installed on your system:

1. .NET SDK

You need the latest .NET SDK (Software Development Kit). You can download it from the official site: https://dotnet.microsoft.com/download

2. Code Editor (Optional but recommended)

You can use:

• Visual Studio Code (cross-platform, lightweight)
• Visual Studio Community Edition (for Windows)
• Any IDE or text editor of your choice

3. Terminal / Command Prompt

You’ll need a terminal (Command Prompt, PowerShell, Terminal, etc.) to execute .NET CLI commands.

Step-by-Step: Create Your First .NET Console App

Step 1: Open the Terminal and Create a New Project

Use the following command to create a new console application in .NET:

dotnet new console -n MyFirstDotNetApp

This will:

• Create a new folder named MyFirstDotNetApp
• Generate a basic project structure with a Program.cs file
• Initialize the project with the necessary configurations

Step 2: Navigate to the Project Directory

cd MyFirstDotNetApp

Step 3: Explore the Project Files

• Program.cs – Entry point of your application
• MyFirstDotNetApp.csproj – Project file with dependencies and settings

Step 4: Understand the Default Program.cs

Open Program.cs file. You will see something like this:

using System;

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

This program does the following:

• Imports the System namespace
• Defines a class called Program
• Has a Main method which is the entry point of the app
• Prints “Hello, World!” to the console

Step 5: Run the Application

dotnet run

You should see the output:

Hello, World!

Customize the Application

Let’s modify the program to accept user input and display a personalized message.

using System;

class Program
{
    static void Main(string[] args)
    {
        Console.WriteLine("Enter your name:");
        string name = Console.ReadLine();
        Console.WriteLine($"Welcome to .NET, {name}!");
    }
}

This version introduces:

• Console.ReadLine() – to accept input from the user
• String interpolation – to format strings easily

Understanding the .NET Project Structure

.csproj File

The .csproj file contains metadata about the project including SDK version, target framework, and dependencies.

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net7.0</TargetFramework>
  </PropertyGroup>

</Project>

Adding a Class to Your Console Application

Let’s separate our logic into a new class file. Create a new file named Greeter.cs:

public class Greeter
{
    public string Greet(string name)
    {
        return $"Hello, {name}! Welcome to the world of .NET!";
    }
}

Now modify the Program.cs to use the new class:

using System;

class Program
{
    static void Main(string[] args)
    {
        Console.Write("Enter your name: ");
        string name = Console.ReadLine();

        Greeter greeter = new Greeter();
        string message = greeter.Greet(name);
        Console.WriteLine(message);
    }
}

Compile and Run Again

dotnet run

You'll now see a personalized greeting using your newly created class.

Useful .NET CLI Commands

• Create project:

  dotnet new console -n AppName

• Restore packages:

  dotnet restore

• Build project:

  dotnet build

• Run project:

  dotnet run

• Publish project:

  dotnet publish -c Release -o ./publish

Debugging Console Applications

If you're using Visual Studio or VS Code, you can set breakpoints, inspect variables, and step through your code. For command-line debugging, you can use:

dotnet build
dotnet run --configuration Debug

Advanced Tips for Console Applications

1. Handle Errors Gracefully

try
{
    Console.Write("Enter a number: ");
    int number = Convert.ToInt32(Console.ReadLine());
    Console.WriteLine($"Square: {number * number}");
}
catch (FormatException)
{
    Console.WriteLine("Please enter a valid number.");
}

2. Use Command-Line Arguments

static void Main(string[] args)
{
    if (args.Length > 0)
    {
        Console.WriteLine("Argument: " + args[0]);
    }
    else
    {
        Console.WriteLine("No arguments passed.");
    }
}

3. Looping and Conditions

for (int i = 1; i <= 5; i++)
{
    Console.WriteLine($"Count: {i}");
}

Congratulations! You've successfully created and customized your first .NET Console Application. This foundational step equips you with the understanding of project structure, syntax, .NET CLI, and best practices. Whether you're a beginner or returning developer, console applications are a perfect playground for mastering .NET and C#. As you grow your knowledge, you’ll be ready to build web APIs, desktop applications, mobile apps, and cloud-native solutions using the versatile .NET ecosystem.