System.InvalidOperationException: Cannot create instance of type 'SetariFacturare' because it is missing a public parameterless constructor.
Legarea configurării (Get<T>, Bind, Configure<T>) trebuie să creeze obiectul de setări, dar clasa nu are un constructor public fără parametri pe care să-l poată folosi. Adaugă un constructor public fără parametri sau folosește proprietăți cu set/init și valori implicite.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
ConfigurationBinder (folosit de Get<T>(), Bind, Configure<T> și BindConfiguration) creează un obiect de tipul cerut, apoi îi completează proprietățile din chei. Pentru asta are nevoie de o cale de a crea obiectul: un constructor public fără parametri sau, din .NET 7, un constructor ai cărui parametri au exact numele cheilor (cum au record-urile poziționale).
Mesajul apare când clasa are doar un constructor privat, sau un constructor cu parametri care nu corespund cheilor (de exemplu SetariFacturare(string serie) când cheia e Prefix). Apare și pentru interfețe și clase abstracte, care nu pot fi create deloc.
Aplicația se oprește în momentul legării: la pornire pentru Get<T>(), sau la prima citire a lui IOptions<T>.Value.
De ce apare: cauzele frecvente
1Constructor cu parametri care nu corespund cheilor
public class SetariFacturare
{
public SetariFacturare(string serie) { Prefix = serie; }
public string Prefix { get; set; }
}public class SetariFacturare
{
public string Prefix { get; set; } = "";
}Fără constructor explicit, clasa are unul public fără parametri, iar legarea completează Prefix din cheia cu același nume.
2Constructor privat
public class SetariFacturare
{
private SetariFacturare() { }
public string Prefix { get; set; } = "";
}public class SetariFacturare
{
public string Prefix { get; set; } = "";
}Legarea nu folosește constructori privați.
3Record pozițional: numele parametrilor contează
public record SetariFacturare(string Serie); // cheia din fișier: Prefixpublic record SetariFacturare(string Prefix);Din .NET 7, record-urile poziționale se pot lega, dar fiecare parametru trebuie să aibă numele unei chei existente.
Repară eroarea, direct în pagină
Aplicația nu pornește: SetariFacturare are un constructor privat, iar Get<SetariFacturare>() nu poate crea obiectul. Rescrie clasa ca obiect simplu de setări (proprietăți publice cu valori implicite), ca GET /factura/urmatoarea să răspundă Următoarea factură: TS-1001.
var builder = WebApplication.CreateBuilder(args);
var facturare = builder.Configuration.GetSection("Facturare").Get<SetariFacturare>()!;
var app = builder.Build();
app.MapGet("/factura/urmatoarea", () => $"Următoarea factură: {facturare.Prefix}-{facturare.Urmatorul}");
app.Run();
public class SetariFacturare
{
// TODO: legarea nu poate folosi constructorul privat
private SetariFacturare() { }
public string Prefix { get; set; } = "";
public int Urmatorul { get; set; }
}GET /factura/urmatoarea → 200 OK Următoarea factură: TS-1001
Indiciu
Șterge constructorul privat; proprietățile publice cu set sunt suficiente.
Reparația
var builder = WebApplication.CreateBuilder(args);
var facturare = builder.Configuration.GetSection("Facturare").Get<SetariFacturare>()!;
var app = builder.Build();
app.MapGet("/factura/urmatoarea", () => $"Următoarea factură: {facturare.Prefix}-{facturare.Urmatorul}");
app.Run();
public class SetariFacturare
{
public string Prefix { get; set; } = "";
public int Urmatorul { get; set; }
}De ce merge
Legarea configurării are nevoie de un constructor public fără parametri. Fără constructor explicit, compilatorul generează unul public, iar binderul completează Prefix și Urmatorul din secțiunea Facturare. Clasele de setări rămân simple, fără logică. Valorile din fișier ajung în proprietăți după crearea obiectului.
Alte forme ale mesajului
System.InvalidOperationException: Cannot create instance of type 'ISetari' because it is either abstract or an interface.
Cum o eviți pe viitor
- Clasele de setări sunt simple: proprietăți publice cu
get; set;sauget; init;și valori implicite. - Nu pune logică în constructorul lor; validările merg în Options (
Validate, DataAnnotations). - Nu lega niciodată o interfață: leagă clasa concretă.
- Scrie un test mic care leagă secțiunea din
appsettings.jsonde clasa de setări și verifică valorile, ca orice schimbare a clasei să fie prinsă înainte de deploy.
Întrebări frecvente
Pot folosi init în loc de set?
Da. Legarea poate completa și proprietățile init, pentru că lucrează prin reflection după crearea obiectului.
De ce merge un record și o clasă cu constructor nu?
Pentru record-ul pozițional, binderul potrivește parametrii constructorului cu cheile după nume. La o clasă cu un constructor oarecare, numele parametrilor nu corespund cheilor, deci nu știe ce valori să dea.
Erori înrudite
System.InvalidOperationException: Failed to convert configuration value 'zece' at 'Cos:MaxProduse' to type 'System.Int32'. O valoare din configurare nu poate fi transformată în tipul cerut: ai cerut int, dar în appsettings.json sau în variabila de mediu e un text ("zece", "20 buc", "1,5"). Corectează valoarea din configurare ca să fie în formatul tipului. System.InvalidOperationException: Section 'Plati' not found in configuration. GetRequiredSection("Plati") nu a găsit secțiunea în nicio sursă de configurare: lipsește din appsettings.json, e scrisă altfel sau e doar în appsettings.Production.json. Adaugă secțiunea sau corectează numele. Î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.
