...
Eroare C# · Erori de sintaxă

error CS1529: A using clause must precede all other elements defined in the namespace except extern alias declarations

Pe scurt

Ai pus o directivă `using` (de exemplu `using System.Text;`) după cod, clase sau namespace-uri. Directivele `using` trebuie să fie primele linii din fișier (sau primele dintr-un namespace). Mută-le sus, înaintea oricărui alt cod.

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

Ce înseamnă

Directivele using spun compilatorului în ce namespace-uri să caute tipurile pe care le folosești (StringBuilder din System.Text, Regex din System.Text.RegularExpressions). Ele trebuie să stea la începutul fișierului, înaintea instrucțiunilor de nivel superior, a claselor și a namespace-urilor. Singurele care pot fi înaintea lor sunt extern alias, folosite foarte rar.

Eroarea apare de obicei când lipești un exemplu găsit pe internet la mijlocul fișierului, cu tot cu using-ul lui, sau când adaugi un using lângă codul care are nevoie de el, în loc de prima linie. Poate apărea și CS0246 pentru tipul din namespace-ul respectiv, pentru că directiva pusă greșit nu se aplică.

Atenție: using var fisier = ...; și using (...) { } sunt instrucțiuni (eliberează resurse), nu directive, și pot sta oriunde în cod.

De ce apare: cauzele frecvente

1Using adăugat după cod

Greșit
C#
Console.WriteLine("Start");
using System.Text;

var sb = new StringBuilder();
Corect
C#
using System.Text;

Console.WriteLine("Start");
var sb = new StringBuilder();

Directiva trebuie să fie înaintea primei instrucțiuni din fișier.

2Using după o clasă sau un namespace

Greșit
C#
namespace Magazin;

class Produs { }

using System.Text.Json;
Corect
C#
using System.Text.Json;

namespace Magazin;

class Produs { }

Toate directivele using se grupează la începutul fișierului, înainte de namespace și de declarațiile de tipuri.

Repară tu

Repară eroarea, direct în pagină

Programul construiește un mesaj cu StringBuilder, dar nu compilează: error CS1529: A using clause must precede all other elements. Mută directiva în locul corect ca programul să afișeze Procesez comanda..., apoi Comanda #12 confirmata.

Codul care dă eroarea
C#
Console.WriteLine("Procesez comanda...");
using System.Text;

var sb = new StringBuilder();
sb.Append("Comanda #").Append(12).Append(" confirmata");
Console.WriteLine(sb.ToString());
După reparație, programul afișează
Procesez comanda...
Comanda #12 confirmata
Indiciu

Directiva using System.Text; trebuie să fie prima linie din fișier.

Cum o eviți pe viitor

  • Ține toate directivele using grupate pe primele linii ale fișierului.
  • Când copiezi un exemplu, mută using-urile lui sus și lipește doar codul la locul potrivit.
  • Lasă editorul să adauge singur using-ul lipsă (acțiunea rapidă de pe numele subliniat): îl pune mereu în locul corect.
  • Pentru namespace-urile folosite în tot proiectul, poți declara global using într-un singur fișier.

Întrebări frecvente

Pot pune using în interiorul unui namespace?

Da, la începutul blocului namespace: namespace Magazin { using System.Text; class A { } }. Regula e aceeași: înaintea oricărei declarații din acel namespace.

De ce nu am nevoie de using System; în proiectele noi?

Proiectele .NET noi au ImplicitUsings activat, care adaugă automat directive globale pentru System, System.Collections.Generic, System.IO, System.Linq, System.Net.Http, System.Threading și System.Threading.Tasks. Pentru alte namespace-uri, ca System.Text, scrii tu directiva.

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.