error CS0246: The type or namespace name 'StringBuilder' could not be found (are you missing a using directive or an assembly reference?)
Compilatorul nu găsește tipul (clasa, structura, interfața) pe care îl folosești. De obicei lipsește directiva `using` (de exemplu `using System.Text;` pentru `StringBuilder`) sau numele tipului e scris greșit.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul are două părți. „The type or namespace name 'StringBuilder' could not be found” înseamnă că numele folosit ca tip nu corespunde niciunui tip vizibil. Paranteza „are you missing a using directive or an assembly reference?” îți sugerează cele două cauze clasice: lipsește un using sau lipsește referința la biblioteca în care e definit tipul.
În .NET, clasele sunt grupate în namespace-uri. Proiectele moderne au câteva using-uri implicite (System, System.Collections.Generic, System.Linq, System.IO, System.Threading.Tasks...), dar nu toate. StringBuilder e în System.Text, Regex în System.Text.RegularExpressions, JsonSerializer în System.Text.Json. Pentru ele scrii using sus în fișier sau numele complet (System.Text.StringBuilder).
Alte cauze: ai scris numele greșit (Stringbuilder, list<int> în loc de List<int>), ai uitat să declari o clasă proprie sau ai numit-o altfel decât o folosești.
De ce apare: cauzele frecvente
1Lipsește using pentru namespace
var sb = new StringBuilder();
sb.Append("Salut");
Console.WriteLine(sb);using System.Text;
var sb = new StringBuilder();
sb.Append("Salut");
Console.WriteLine(sb);StringBuilder se află în System.Text, care nu e importat implicit. Directiva using îl face vizibil.
2Tip scris cu literă mică
list<int> note = new list<int>();List<int> note = new List<int>();Tipul se numește List<T>. C# face diferența între litere mari și mici, iar list nu există.
3Clasa proprie are alt nume
var c = new Client("Ana");
class Clienti
{
public string Nume;
public Clienti(string nume) { Nume = nume; }
}var c = new Client("Ana");
class Client
{
public string Nume;
public Client(string nume) { Nume = nume; }
}Folosești tipul Client, dar ai declarat Clienti. Numele trebuie să fie identice.
Repară eroarea, direct în pagină
Programul construiește o listă de produse cu StringBuilder, dar primești error CS0246: The type or namespace name 'StringBuilder' could not be found. Repară programul fără să renunți la StringBuilder, astfel încât să afișeze lista produselor numerotate.
string[] produse = { "Paine", "Lapte", "Cafea" };
var sb = new StringBuilder();
for (int i = 0; i < produse.Length; i++)
{
sb.AppendLine($"{i + 1}. {produse[i]}");
}
Console.Write(sb.ToString());1. Paine 2. Lapte 3. Cafea
Indiciu
StringBuilder se află în namespace-ul System.Text.
Reparația
using System.Text;
string[] produse = { "Paine", "Lapte", "Cafea" };
var sb = new StringBuilder();
for (int i = 0; i < produse.Length; i++)
{
sb.AppendLine($"{i + 1}. {produse[i]}");
}
Console.Write(sb.ToString());De ce merge
StringBuilder nu este în niciunul dintre namespace-urile importate implicit, așa că compilatorul nu știa ce înseamnă numele. Directiva using System.Text; de la începutul fișierului îl face vizibil (la fel de bine poți scrie new System.Text.StringBuilder()). Restul codului era corect: AppendLine adaugă fiecare produs pe un rând nou, iar la final ToString() întoarce textul complet, pe care îl afișezi cu Console.Write.
Alte forme ale mesajului
error CS0246: The type or namespace name 'Regex' could not be found (are you missing a using directive or an assembly reference?)error CS0234: The type or namespace name 'Json' does not exist in the namespace 'System.Text' (are you missing an assembly reference?)
Cum o eviți pe viitor
- Lasă editorul să adauge
using-ul: în Visual Studio și VS Code, sugestia apare cu Ctrl+. pe numele subliniat. - Reține namespace-urile frecvente:
System.Text(StringBuilder),System.Text.RegularExpressions(Regex),System.Text.Json(JsonSerializer),System.Globalization(CultureInfo). - Respectă PascalCase la numele de tipuri:
List,Dictionary,DateTime. - Când ai o clasă proprie, folosește aceeași denumire peste tot (redenumirea automată din editor ajută).
Întrebări frecvente
De ce merge List fără using, dar StringBuilder nu?
Proiectele .NET moderne au ImplicitUsings activat, care adaugă automat câteva namespace-uri uzuale, printre care System.Collections.Generic. System.Text nu e printre ele, deci trebuie importat explicit.
Ce înseamnă „assembly reference”?
Unele tipuri sunt în biblioteci separate (pachete NuGet). Dacă biblioteca nu e adăugată în proiect, nici using nu ajută: trebuie instalat pachetul. Pentru clasele din .NET de bază e suficient using.
Erori înrudite
error CS0103: The name 'x' does not exist in the current context Folosești un nume (variabilă, metodă, clasă) pe care compilatorul nu îl găsește în locul acela. De obicei e o greșeală de scriere, o variabilă declarată în alt bloc sau înainte de declarație; scrie numele exact cum l-ai declarat și declară-l într-un loc vizibil. error CS1061: 'string' does not contain a definition for 'length' and no accessible extension method 'length' accepting a first argument of type 'string' could be found (are you missing a using directive or an assembly reference?) Apelezi pe un obiect o metodă sau o proprietate care nu există pentru tipul lui: de obicei e o greșeală de scriere (`length` în loc de `Length`) sau confunzi tipurile (`Length` la o listă, unde e `Count`). Scrie membrul exact, cu literele mari corecte. error CS0117: 'Console' does not contain a definition for 'Writeline' Apelezi un membru static care nu există în clasa respectivă, de cele mai multe ori din cauza unei litere greșite: `Console.Writeline` în loc de `Console.WriteLine`. Scrie numele exact, cu literele mari la locul lor. Î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.
