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. Nigdy oba w jednym projekcie.

3. Pozostałe pułapki

Zadania

Console.WriteLine("Imię: Grzegorz");
Console.WriteLine("Klasa: 2 TI");
Console.WriteLine("Ulubiony przedmiot: programowanie");

Console.Write("Rok: ");
Console.Write(2026);
Console.WriteLine();

using System;

namespace Wizytowka
{
    class Program
    {
        static void Main(string[] args)
        {
            Console.WriteLine("Imię: Grzegorz");
            Console.WriteLine("Klasa: 2 TI");
            Console.WriteLine("Ulubiony przedmiot: programowanie");

            Console.Write("Rok: ");
            Console.Write(2026);
            Console.WriteLine();
        }
    }
}

class Uczen
{
    public string Imie
}

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

Uczen u = new Uczen();              // 3. dodany średnik + klasa przeniesiona niżej
u.Imie = "Ala";
Console.WriteLine(u.Imie);          // 2. WriteLine, nie Writeline

class Uczen
{
    public string Imie;             // 1. dodany średnik po deklaracji pola
}

Console.Write("Podaj szerokość: ");
int szerokosc = int.Parse(Console.ReadLine());

Console.Write("Podaj wysokość: ");
int wysokosc = int.Parse(Console.ReadLine());

int pole = szerokosc * wysokosc;
int obwod = 2 * (szerokosc + wysokosc);

Console.WriteLine($"Pole: {pole}");
Console.WriteLine($"Obwód: {obwod}");

Co trzeba zapamiętać

• Każdy program w C# ma punkt wejścia — metodę Main, od której zaczyna się wykonywanie.
• Od C# 9 można pisać instrukcje najwyższego poziomu: kompilator sam opakowuje je w klasę z Main.
• Oba zapisy dają identyczny program — różnią się wyłącznie tym, ile widać rusztowania.
• W pliku z instrukcjami najwyższego poziomu instrukcje muszą poprzedzać deklaracje klas (CS8803).
• Punkt wejścia może być tylko jeden — nie da się połączyć Main z instrukcjami najwyższego poziomu.
• ImplicitUsings dopisuje najpopularniejsze przestrzenie nazw, ale nie wszystkie — System.Text i System.Globalization trzeba dodać samemu.
• Na egzaminie zawodowym pisz w zapisie klasycznym: jest jednoznaczny i działa wszędzie.