System.ArgumentNullException: Value cannot be null. (Parameter 'source')
O metodă LINQ (Count, Where, ToList) a primit null în loc de colecție. În EF Core, cauza tipică e un DbSet declarat ca simplu câmp (fără { get; set; }), pe care EF nu-l inițializează. Declară-l ca proprietate sau ca => Set<T>().
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
ArgumentNullException cu Parameter 'source' vine din LINQ: toate metodele de extensie (Count, Where, Select, ToList, First) au primul parametru numit source, colecția pe care lucrează. Dacă acel obiect e null, metoda refuză să continue.
Într-un proiect cu EF Core, cel mai des null este chiar DbSet-ul. La crearea contextului, EF caută proprietățile publice de tip DbSet<T> cu setter și le atribuie automat câte un set. Un câmp public (public DbSet<Carte> Carti;), o proprietate fără setter sau una privată nu sunt inițializate și rămân null. Compilatorul nu protestează, iar avertismentul de nullable dispare dacă ai scris = null!.
Alte surse ale aceluiași mesaj: o listă dintr-un DTO care nu a venit în JSON (comanda.Produse.Sum(...) cu Produse null) sau o colecție de navigare fără inițializare. Stiva îți arată metoda LINQ; variabila din fața ei e cea nulă.
De ce apare: cauzele frecvente
1DbSet declarat ca câmp
public class Biblioteca(DbContextOptions<Biblioteca> o) : DbContext(o)
{
public DbSet<Carte> Carti;
}public class Biblioteca(DbContextOptions<Biblioteca> o) : DbContext(o)
{
public DbSet<Carte> Carti { get; set; }
}EF inițializează doar proprietățile DbSet cu setter.
2Proprietate fără setter
public DbSet<Carte> Carti { get; } = null!;public DbSet<Carte> Carti => Set<Carte>();Varianta => Set<Carte>() nu depinde de inițializarea automată și nu are nevoie de null!.
3Listă lipsă din cererea JSON
var total = comanda.Produse.Sum(p => p.Pret);var total = (comanda.Produse ?? []).Sum(p => p.Pret);
// sau: public List<ProdusCos> Produse { get; set; } = [];Inițializează colecțiile din DTO-uri cu [], ca lipsa lor din JSON să dea o listă goală.
Repară eroarea, direct în pagină
GET /carti/numar răspunde 500 cu Value cannot be null. (Parameter 'source'). Repară declarația setului Carti din context, ca EF să-l inițializeze, iar endpoint-ul să răspundă cu numărul de cărți (0).
using Microsoft.EntityFrameworkCore;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddDbContext<Biblioteca>(o => o.UseInMemoryDatabase("biblioteca"));
var app = builder.Build();
app.MapGet("/carti/numar", (Biblioteca db) => db.Carti.Count());
app.Run();
public class Carte
{
public int Id { get; set; }
public string Titlu { get; set; } = "";
public string Autor { get; set; } = "";
}
public class Biblioteca(DbContextOptions<Biblioteca> options) : DbContext(options)
{
public DbSet<Carte> Carti;
}GET /carti/numar → 200 OK 0
Indiciu
EF inițializează automat doar proprietățile DbSet, nu și câmpurile.
Reparația
using Microsoft.EntityFrameworkCore;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddDbContext<Biblioteca>(o => o.UseInMemoryDatabase("biblioteca"));
var app = builder.Build();
app.MapGet("/carti/numar", (Biblioteca db) => db.Carti.Count());
app.Run();
public class Carte
{
public int Id { get; set; }
public string Titlu { get; set; } = "";
public string Autor { get; set; } = "";
}
public class Biblioteca(DbContextOptions<Biblioteca> options) : DbContext(options)
{
public DbSet<Carte> Carti { get; set; }
}De ce merge
public DbSet<Carte> Carti; era un câmp, pe care EF nu îl completează, deci rămânea null, iar Count() arunca ArgumentNullException pentru parametrul source. Ca proprietate cu { get; set; }, EF îi atribuie setul la crearea contextului (la fel de bine merge => Set<Carte>()). Biblioteca e goală, deci răspunsul e 0.
Alte forme ale mesajului
System.ArgumentNullException: Value cannot be null. (Parameter 'source') at System.Linq.ThrowHelper.ThrowArgumentNullException(ExceptionArgument argument)
Cum o eviți pe viitor
- Declară seturile contextului ca
public DbSet<T> Nume => Set<T>();sau{ get; set; }. - Nu folosi
= null!ca să scapi de avertismente fără să știi cine inițializează valoarea. - Inițializează colecțiile din DTO-uri și entități cu
[].
Întrebări frecvente
De ce nu primesc NullReferenceException?
Pentru că nu accesezi un membru al obiectului null, ci îl dai ca argument unei metode LINQ, care verifică explicit parametrii și aruncă ArgumentNullException cu numele parametrului.
Care variantă e mai bună: { get; set; } sau => Set<T>()?
Ambele funcționează. => Set<T>() e mai sigură cu nullable reference types (nu ai nevoie de null!) și e recomandată în documentația EF pentru proiecte cu NRT activat.
Erori înrudite
System.InvalidOperationException: Cannot create a DbSet for 'Absenta' because this type is not included in the model for the context. Folosești db.Set<Absenta>() (sau un repository generic) pentru o clasă pe care contextul nu o cunoaște. Adaug-o în model: o proprietate DbSet<Absenta> în context, o configurare în OnModelCreating sau o navigare dintr-o entitate existentă. System.InvalidOperationException: No database provider has been configured for this DbContext. A provider can be configured by overriding the 'DbContext.OnConfiguring' method or by using 'AddDbContext' on the application service provider. If 'AddDbContext' is used, then also ensure that your DbContext type accepts a DbContextOptions<TContext> object in its constructor and passes it to the base constructor for DbContext. DbContext-ul nu știe la ce bază de date să se conecteze. Alege providerul în AddDbContext (UseSqlServer, UseNpgsql, UseSqlite sau UseInMemoryDatabase) și asigură-te că AppDb primește DbContextOptions<AppDb> în constructor și le trimite la base(options). Î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.
