Pierwszy program: Main czy instrukcje najwyższego poziomu?

Czego się dziś nauczysz

Dlaczego pierwszy program wygląda u każdego inaczej

Gdy w Visual Studio utworzysz projekt Console App dla .NET 6 lub nowszego, w pliku Program.cs znajdziesz coś takiego:

// See https://aka.ms/new-console-template for more information
Console.WriteLine("Hello, World!");

Dwie linijki. Żadnej klasy, żadnego Main, żadnego using System;. Tymczasem w książkach, na starszych kursach i na arkuszach egzaminacyjnych ten sam program wygląda tak:

using System;

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

Oba programy robią dokładnie to samo i oba są poprawne. Krótszy zapis nazywa się instrukcjami najwyższego poziomu (ang. top-level statements) i pojawił się w C# 9. Nie jest to jednak nowy, „inny” sposób pisania programów — to skrót, który kompilator sam rozwija do postaci klasycznej.

Skąd znikło using System;

To osobny mechanizm, wprowadzony razem z .NET 6, nazywany niejawnymi dyrektywami using (ang. implicit usings). Projekt konsolowy dopisuje za ciebie kilka najczęściej używanych przestrzeni nazw — między innymi System, System.Collections.Generic, System.Linq i System.IO. Dlatego Console, List czy File działają od razu.

Zajrzyj do pliku projektu .csproj — to tam jest włączane:

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net8.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
  </PropertyGroup>
</Project>

Anatomia zapisu klasycznego

Nawet jeśli na co dzień będziesz pisać krótko, musisz rozumieć wersję pełną — spotkasz ją w każdym starszym kodzie, w dokumentacji i na egzaminie zawodowym.

Który zapis wybrać?

W tym kursie przykłady krótkie zapisujemy skrótowo, a wszędzie tam, gdzie pojawiają się własne klasy, wracamy do zapisu z Main. Każdy listing będzie miał w nagłówku informację, gdzie go wkleić.

Co dokładnie robi każdy użyty element

Ten sam program napisany na dwa sposoby

Program pyta o imię i rok urodzenia, po czym wypisuje powitanie i wiek. Najpierw krótko:

Console.Write("Jak masz na imię? ");
string imie = Console.ReadLine();

Console.Write("W którym roku się urodziłeś? ");
int rok = int.Parse(Console.ReadLine());

int wiek = 2026 - rok;

Console.WriteLine($"Cześć, {imie}! W tym roku kończysz {wiek} lat.");

A teraz dokładnie to samo w zapisie klasycznym:

using System;

namespace Powitanie
{
    class Program
    {
        static void Main(string[] args)
        {
            Console.Write("Jak masz na imię? ");
            string imie = Console.ReadLine();

            Console.Write("W którym roku się urodziłeś? ");
            int rok = int.Parse(Console.ReadLine());

            int wiek = 2026 - rok;

            Console.WriteLine($"Cześć, {imie}! W tym roku kończysz {wiek} lat.");
        }
    }
}

Jak masz na imię? Grzegorz
W którym roku się urodziłeś? 2008
Cześć, Grzegorz! W tym roku kończysz 18 lat.

Omówienie

Na co uważać

1. Klasa przed instrukcjami — najczęstszy błąd przy kopiowaniu kodu

To pułapka, w którą wpada niemal każdy, kto skopiuje przykład ze strony internetowej i wklei go na początek swojego Program.cs:

class Samochod            // ✗ najpierw klasa…
{
    public string Marka;
}

Samochod auto = new Samochod();    // ✗ CS8803: Top-level statements must precede
auto.Marka = "Toyota";             //   namespace and type declarations
Console.WriteLine(auto.Marka);

W pliku z instrukcjami najwyższego poziomu obowiązuje sztywna kolejność: najpierw instrukcje, dopiero potem deklaracje klas. Wystarczy zamienić bloki miejscami:

Samochod auto = new Samochod();    // ✓ najpierw instrukcje
auto.Marka = "Toyota";
Console.WriteLine(auto.Marka);

class Samochod                      // ✓ klasa na końcu pliku
{
    public string Marka;
}

2. Dwa punkty wejścia naraz

Console.WriteLine("Start");        // instrukcja najwyższego poziomu

class Program
{
    static void Main()             // ✗ CS8802: Only one compilation unit
    {                              //   can have top-level statements
        Console.WriteLine("Main");
    }
}

Wybierz jedno: albo instrukcje najwyższego poziomu, albo Main. Łączenie obu jest możliwe, ale wprowadza niepotrzebne zamieszanie: jawne Main nie zostanie wybrane jako punkt startu.

3. Pozostałe pułapki

Zadania

Console.WriteLine("Dziennik klasy 4TP");
Console.WriteLine("---------------------");
Console.WriteLine("Uczniow: 24");

class Uczen
{
    public string Imie
}

Uczen u = new Uczen()
u.Imie = "Ala";
Console.Writeline(u.Imie);

Co trzeba zapamiętać

• Aplikacja wykonywalna potrzebuje wybranego punktu wejścia. Biblioteka klas nie potrzebuje Main.
• Instrukcje najwyższego poziomu pozwalają pominąć jawną klasę Program i metodę startową.
• Instrukcje najwyższego poziomu mogą być w jednym pliku projektu i muszą poprzedzać deklaracje typów w tym pliku.
• Gdy są instrukcje najwyższego poziomu, jawna metoda Main nie jest wybierana jako punkt wejścia: pojawia się ostrzeżenie CS7022.
• Kilka pasujących metod Main wymaga jednoznacznego wskazania punktu startu.
• ImplicitUsings udostępnia wybrane przestrzenie nazw. System.Text i System.Globalization zwykle dodajemy jawnie.
• W zadaniu szkolnym lub egzaminacyjnym dobierz zapis do polecenia i dostępnego środowiska.