...
Eroare C# · Metode, parametri și structura programului

error CS8803: Top-level statements must precede namespace and type declarations.

Pe scurt

Într-un program scris cu top-level statements (fără `Main`), ai pus instrucțiuni după declarația unei clase, a unui record sau a unui enum. Mută toate instrucțiunile la începutul fișierului și declară tipurile la final.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Începând cu C# 9 poți scrie programul direct, fără class Program și static void Main: instrucțiunile din fișier („top-level statements”) devin automat corpul lui Main. Regula este însă strictă: toate instrucțiunile trebuie să fie la începutul fișierului, înaintea oricărei declarații de tip (class, record, struct, enum, interface) sau namespace.

Mesajul „Top-level statements must precede namespace and type declarations” apare când ai scris o clasă, iar sub ea ai continuat cu cod (var p = new Produs();). Coordonatele din mesaj indică prima instrucțiune aflată după o declarație de tip.

Funcțiile locale (static int Dublu(int n) => n * 2;) nu sunt tipuri: pot sta printre instrucțiuni sau după ele. Doar clasele, record-urile, enum-urile și celelalte tipuri trebuie mutate la final. Acesta este și stilul folosit în lecțiile și exercițiile noastre: întâi programul, apoi tipurile.

De ce apare: cauzele frecvente

1Clasa declarată înaintea codului

Greșit
C#
class Produs
{
    public string Nume = "Carte";
}

var p = new Produs();
Console.WriteLine(p.Nume);
Corect
C#
var p = new Produs();
Console.WriteLine(p.Nume);

class Produs
{
    public string Nume = "Carte";
}

Instrucțiunile trebuie să fie primele în fișier; clasa vine după ele și poate fi folosită fără probleme.

2Un enum între instrucțiuni

Greșit
C#
var s = Status.Nou;
enum Status { Nou, Livrat }
Console.WriteLine(s);
Corect
C#
var s = Status.Nou;
Console.WriteLine(s);

enum Status { Nou, Livrat }

După enum nu mai pot urma instrucțiuni. Toate instrucțiunile se grupează sus.

3record declarat la mijloc

Greșit
C#
record Punct(int X, int Y);
var a = new Punct(1, 2);
Console.WriteLine(a);
Corect
C#
var a = new Punct(1, 2);
Console.WriteLine(a);

record Punct(int X, int Y);

Și record este o declarație de tip, deci trebuie mutat după instrucțiuni.

Repară tu

Repară eroarea, direct în pagină

Programul creează două produse și le afișează, dar primești error CS8803: Top-level statements must precede namespace and type declarations. Reorganizează fișierul fără să schimbi codul, astfel încât programul să compileze și să afișeze cele două produse.

Codul care dă eroarea
C#
var p1 = new Produs("Carte", 45m);

class Produs
{
    public string Nume { get; }
    public decimal Pret { get; }
    public Produs(string nume, decimal pret) { Nume = nume; Pret = pret; }
}

var p2 = new Produs("Pix", 3.5m);
Console.WriteLine($"{p1.Nume}: {p1.Pret:F2}");
Console.WriteLine($"{p2.Nume}: {p2.Pret:F2}");
După reparație, programul afișează
Carte: 45.00
Pix: 3.50
Indiciu

Mută declarația clasei Produs la finalul fișierului, după instrucțiuni.

Alte forme ale mesajului

  • error CS8802: Only one compilation unit can have top-level statements.

Cum o eviți pe viitor

  • Organizează fișierul mereu la fel: using-uri, apoi instrucțiunile programului, apoi funcțiile locale, apoi tipurile (clase, record-uri, enum-uri).
  • Când adaugi o clasă nouă, scrie-o la finalul fișierului.
  • Pentru programe mai mari, pune fiecare clasă în fișierul ei.
  • Dacă preferi stilul clasic, scrie class Program { static void Main(string[] args) { ... } }, dar nu amesteca cele două stiluri.

Întrebări frecvente

Pot folosi o clasă declarată mai jos în fișier?

Da. Ordinea declarațiilor de tip nu contează pentru compilator: o clasă declarată la final poate fi folosită în instrucțiunile de sus. Regula privește doar instrucțiunile, care trebuie să fie primele.

Ce e CS8802?

Apare când două fișiere din același proiect au top-level statements. Doar un fișier poate fi „punctul de intrare” scris în acest stil.

Erori înrudite

← Toate erorile C#

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață C# de la zero, cu exerciții la fiecare lecție

Curs C#: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.