...
Eroare ASP.NET Core · Configurare, Options și logging

System.InvalidOperationException: Cannot create instance of type 'SetariFacturare' because it is missing a public parameterless constructor.

Pe scurt

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

Greșit
C#
public class SetariFacturare
{
    public SetariFacturare(string serie) { Prefix = serie; }
    public string Prefix { get; set; }
}
Corect
C#
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

Greșit
C#
public class SetariFacturare
{
    private SetariFacturare() { }
    public string Prefix { get; set; } = "";
}
Corect
C#
public class SetariFacturare
{
    public string Prefix { get; set; } = "";
}

Legarea nu folosește constructori privați.

3Record pozițional: numele parametrilor contează

Greșit
C#
public record SetariFacturare(string Serie); // cheia din fișier: Prefix
Corect
C#
public 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ă tu

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.

Codul care dă eroarea
C#
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; }
}
După reparație, programul afișează
GET /factura/urmatoarea → 200 OK
Următoarea factură: TS-1001
Indiciu

Șterge constructorul privat; proprietățile publice cu set sunt suficiente.

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; sau get; 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.json de 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

← 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.