C# Top-level statements

Use top-level statements in C# to reduce boilerplate code.

Top-level statements can take your code to the... top level.

Top-level statements

Top-level statements were introduced in C# 9 as a syntax feature that allows you to reduce code by removing the Main method and its associated class. While the compiler needs this information to build the program, the programmer doesn't need to see any of it in most cases. The programmer only needs to see the working code. This means you can place executable code at the top of the file starting right on line 1. Hence, "top-level" statements.

A few caveats about top-level statements:

  • You can only use top-level statements in one file in a project. Most likely, Program.cs, as most developers expect to see an entry point in a file with this name.
  • Any code blocks such as type definitions or methods after the individual lines of code are not considered top-level.
  • Top-level statements are excellent for simplifying smaller applications. They might not work well in large or complex apps that need the extra structure.

Top-level statements are great for Minimal APIs.

Refactoring to use top-level statements

If you'd like to convert your program to use top-level statements, click the light bulb 💡 or press Alt + Enter anywhere on the same line as Main or the class declaration (including brackets). Choose Convert to top-level code

top-level-statement.png

A basic "Hello World" program that's been refactored to use top-level statements goes from this:

using System;

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

to this:

Console.WriteLine("Hello modern code!");

That's quite a difference. Your eyes focus on the executable code immediately. As you can see, a Main function isn't always necessary, or very readable, from a developer's perspective. The good news is that you can ditch the traditional entry point code for a lot of your future C# work.


Related Resources

File-scoped namespaces and types
File-scoped namespaces and types
Organize code better and reduce bugs by using file-scoped namespaces and objects.
Global usings
Global usings
Organize `using` statements so they're out of your way.
Use collection initializers
Use collection initializers
Update and initialize items in old collection declarations.