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

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

Pe scurt

Compilatorul nu știe ce este DbContext pentru că lipsește directiva using Microsoft.EntityFrameworkCore; din fișier sau pachetul EF Core nu e instalat în proiect. Adaugă using-ul (și pachetul providerului, de exemplu Microsoft.EntityFrameworkCore.SqlServer) și eroarea dispare.

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

Ce înseamnă

Mesajul spune că numele DbContext nu corespunde niciunui tip vizibil în fișier. Paranteza sugerează cele două cauze: lipsește un using sau lipsește referința la biblioteca în care e definit tipul.

Un proiect dotnet new web are using-uri implicite pentru ASP.NET Core (Microsoft.AspNetCore.Builder, Microsoft.AspNetCore.Http, Microsoft.Extensions.DependencyInjection și altele), dar Entity Framework Core nu face parte din framework: vine din pachete NuGet separate, iar namespace-ul Microsoft.EntityFrameworkCore trebuie importat explicit. Fără el nu sunt vizibile nici DbContext, DbSet<T>, DbContextOptions<T>, nici metodele de extensie UseSqlServer, UseSqlite, UseInMemoryDatabase, ToListAsync sau Include.

De obicei vezi mai multe erori deodată (pentru fiecare tip EF folosit). Repară-o pe prima, apoi recompilează: celelalte dispar împreună cu ea.

De ce apare: cauzele frecvente

1Lipsește using Microsoft.EntityFrameworkCore;

Greșit
C#
var builder = WebApplication.CreateBuilder(args);
// ...
public class MagazinDb : DbContext
{
    public DbSet<Produs> Produse => Set<Produs>();
}
Corect
C#
using Microsoft.EntityFrameworkCore;

var builder = WebApplication.CreateBuilder(args);
// ...
public class MagazinDb : DbContext
{
    public DbSet<Produs> Produse => Set<Produs>();
}

DbContext e definit în namespace-ul Microsoft.EntityFrameworkCore, care nu e printre using-urile implicite ale proiectelor web.

2Pachetul EF Core nu e instalat

Greșit
C#
dotnet new web -n Magazin
# DbContext folosit fără niciun pachet EF
Corect
C#
dotnet add package Microsoft.EntityFrameworkCore.SqlServer
# sau .Sqlite / .InMemory / Npgsql.EntityFrameworkCore.PostgreSQL

Pachetul providerului aduce și Microsoft.EntityFrameworkCore ca dependență. Fără niciun pachet, nici using-ul nu ajută: namespace-ul nu există în proiect.

3Versiunea pachetului nu se potrivește cu framework-ul

Greșit
C#
<TargetFramework>net8.0</TargetFramework>
<PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="9.0.0" />
Corect
C#
<TargetFramework>net8.0</TargetFramework>
<PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="8.0.11" />

EF Core 9 cere .NET 8 sau mai nou, dar EF Core 10 cere .NET 10. Un pachet incompatibil nu se restaurează, iar tipurile lui nu ajung în proiect.

Repară tu

Repară eroarea, direct în pagină

API-ul de produse folosește Entity Framework Core cu o bază în memorie, dar nu compilează: CS0246: The type or namespace name 'DbContext' could not be found. Repară programul ca POST /produse să adauge produsul, iar GET /produse să întoarcă lista.

Codul care dă eroarea
C#
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddDbContext<MagazinDb>(o => o.UseInMemoryDatabase("magazin"));
var app = builder.Build();

app.MapGet("/produse", (MagazinDb db) => db.Produse.ToList());
app.MapPost("/produse", (Produs produs, MagazinDb db) =>
{
    db.Produse.Add(produs);
    db.SaveChanges();
    return Results.Created($"/produse/{produs.Id}", produs);
});

app.Run();

public class Produs
{
    public int Id { get; set; }
    public string Nume { get; set; } = "";
    public decimal Pret { get; set; }
}

public class MagazinDb(DbContextOptions<MagazinDb> options) : DbContext(options)
{
    public DbSet<Produs> Produse => Set<Produs>();
}
După reparație, programul afișează
POST /produse → 201 Created
Location: /produse/1
{"id":1,"nume":"Mouse","pret":99}
GET /produse → 200 OK
[{"id":1,"nume":"Mouse","pret":99}]
Indiciu

Tipurile EF Core se află în namespace-ul Microsoft.EntityFrameworkCore.

Alte forme ale mesajului

  • error CS0246: The type or namespace name 'DbSet<>' could not be found (are you missing a using directive or an assembly reference?)
  • error CS0246: The type or namespace name 'DbContextOptions<>' could not be found (are you missing a using directive or an assembly reference?)
  • error CS1061: 'DbContextOptionsBuilder' does not contain a definition for 'UseSqlServer' and no accessible extension method 'UseSqlServer' accepting a first argument of type 'DbContextOptionsBuilder' could be found (are you missing a using directive or an assembly reference?)

Cum o eviți pe viitor

  • Când creezi un DbContext, adaugă din prima using Microsoft.EntityFrameworkCore; (sau pune-l într-un fișier GlobalUsings.cs cu global using).
  • Instalează pachetul providerului cu dotnet add package și verifică în .csproj că versiunea majoră se potrivește cu TargetFramework.
  • Folosește sugestia editorului (Ctrl+. pe numele subliniat): îți propune using-ul corect sau instalarea pachetului.

Întrebări frecvente

De ce merge WebApplication fără using, dar DbContext nu?

WebApplication face parte din ASP.NET Core, iar SDK-ul web adaugă automat using-urile lui (ImplicitUsings). EF Core este o bibliotecă separată, adusă prin NuGet, deci namespace-ul ei se importă explicit.

Am pus using-ul, dar UseSqlServer tot nu există. De ce?

UseSqlServer vine din pachetul Microsoft.EntityFrameworkCore.SqlServer. Dacă ai instalat doar Microsoft.EntityFrameworkCore (sau alt provider), metoda de extensie lipsește. Instalează pachetul providerului pe care îl folosești.

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.