...
Eroare ASP.NET Core · Compilare și pornirea aplicației

error CS0246: The type or namespace name 'ControllerBase' could not be found (are you missing a using directive or an assembly reference?)

Pe scurt

Clasa ControllerBase și atributele [ApiController], [Route], [HttpGet] sunt în namespace-ul Microsoft.AspNetCore.Mvc, care nu e importat implicit în Program.cs. Adaugă using Microsoft.AspNetCore.Mvc; sus în fișierul controllerului.

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

Ce înseamnă

Mesajul apare când scrii un controller fără să imporți namespace-ul MVC. ControllerBase, [ApiController], [Route], [HttpGet], [HttpPost], ActionResult<T>, IActionResult, [FromBody] și [FromQuery] stau toate în Microsoft.AspNetCore.Mvc. Un proiect dotnet new webapi creat cu opțiunea de controllere are deja using-ul în fiecare fișier generat; când adaugi tu o clasă nouă sau muți un controller în Program.cs, îl uiți ușor.

De obicei compilatorul raportează o serie de erori pentru același fișier: ControllerBase, apoi ApiControllerAttribute, ApiController, RouteAttribute, Route (pentru fiecare atribut caută și numele cu sufixul Attribute). Toate au aceeași cauză și dispar cu un singur using.

Dacă using-ul există și eroarea persistă, verifică SDK-ul proiectului: o bibliotecă de clase obișnuită (Microsoft.NET.Sdk) nu are ASP.NET Core și are nevoie de <FrameworkReference Include="Microsoft.AspNetCore.App" />.

De ce apare: cauzele frecvente

1Lipsește using Microsoft.AspNetCore.Mvc;

Greșit
C#
[ApiController]
[Route("api/produse")]
public class ProduseController : ControllerBase
{
}
Corect
C#
using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("api/produse")]
public class ProduseController : ControllerBase
{
}

Implicit, un proiect web importă namespace-urile pentru Minimal APIs, nu și pe cele MVC. using-ul face vizibile clasa de bază și atributele.

2Controllerul e într-o bibliotecă de clase fără ASP.NET Core

Greșit
C#
<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net8.0</TargetFramework>
  </PropertyGroup>
</Project>
Corect
C#
<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net8.0</TargetFramework>
  </PropertyGroup>
  <ItemGroup>
    <FrameworkReference Include="Microsoft.AspNetCore.App" />
  </ItemGroup>
</Project>

Proiectele Microsoft.NET.Sdk nu referă ASP.NET Core. Fără FrameworkReference, namespace-ul Microsoft.AspNetCore.Mvc nu există, deci nici using-ul nu compilează.

Repară tu

Repară eroarea, direct în pagină

Controllerul ProduseController nu compilează: CS0246: The type or namespace name 'ControllerBase' could not be found, urmată de erori pentru atribute. Repară fișierul ca GET /api/produse să întoarcă lista de produse.

Codul care dă eroarea
C#
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllers();
var app = builder.Build();
app.MapControllers();
app.Run();

public record Produs(int Id, string Nume, decimal Pret);

[ApiController]
[Route("api/produse")]
public class ProduseController : ControllerBase
{
    private static readonly List<Produs> produse = [new(1, "Laptop", 3500m), new(2, "Mouse", 99m)];

    [HttpGet]
    public List<Produs> GetAll() => produse;
}
După reparație, programul afișează
GET /api/produse → 200 OK
[{"id":1,"nume":"Laptop","pret":3500},{"id":2,"nume":"Mouse","pret":99}]
Indiciu

Clasa de bază a controllerelor și atributele lor sunt în același namespace MVC.

Alte forme ale mesajului

  • error CS0246: The type or namespace name 'ApiControllerAttribute' could not be found (are you missing a using directive or an assembly reference?)
  • error CS0246: The type or namespace name 'Route' could not be found (are you missing a using directive or an assembly reference?)
  • error CS0246: The type or namespace name 'IActionResult' could not be found (are you missing a using directive or an assembly reference?)
  • error CS0246: The type or namespace name 'HttpGetAttribute' could not be found (are you missing a using directive or an assembly reference?)

Cum o eviți pe viitor

  • Pune using Microsoft.AspNetCore.Mvc; în fiecare fișier de controller (șablonul din IDE îl adaugă automat dacă alegi „API Controller”).
  • Dacă ai multe controllere, poți adăuga global using Microsoft.AspNetCore.Mvc; într-un singur fișier.
  • În bibliotecile care conțin controllere sau filtre, adaugă FrameworkReference la Microsoft.AspNetCore.App, nu pachete NuGet vechi de tip Microsoft.AspNetCore.Mvc.Core 2.x.

Întrebări frecvente

De ce primesc cinci erori diferite pentru o singură problemă?

Compilatorul raportează fiecare nume necunoscut: clasa de bază și fiecare atribut (pentru [Route] caută atât Route, cât și RouteAttribute). Toate vin din același using lipsă.

Trebuie să instalez vreun pachet NuGet pentru controllere?

Nu, în proiectele Microsoft.NET.Sdk.Web controllerele fac parte din framework. Ai nevoie doar de builder.Services.AddControllers() și app.MapControllers() în Program.cs.

Erori înrudite

← Toate erorile ASP.NET Core

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ță ASP.NET Core de la zero, cu exerciții la fiecare lecție

Curs ASP.NET Core: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 20 lecții sunt gratuite.