The value '2' is invalid.
Valoarea a putut fi citită, dar nu e acceptată pentru tipul parametrului, cel mai des un număr care nu corespunde niciunei valori dintr-un enum (?stare=2 când enum-ul are doar 0 și 1). Trimite o valoare existentă sau adaugă valoarea lipsă în enum.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În controllere, model binding-ul pentru enum-uri acceptă atât numele valorii (?stare=Livrata, fără să conteze majusculele), cât și numărul ei (?stare=1). Dacă numărul nu corespunde niciunei valori definite, binding-ul raportează The value '2' is invalid. sub numele parametrului, iar [ApiController] răspunde 400.
Diferența față de The value 'x' is not valid for stare.: acolo textul nu putea fi convertit deloc (de exemplu un nume inexistent); aici conversia numerică a reușit, dar valoarea nu există în enum.
Apare des după ce clientul și serverul au versiuni diferite ale aceluiași enum (clientul are deja Anulata = 2, serverul nu), sau când cineva trimite indexul greșit dintr-o listă.
De ce apare: cauzele frecvente
1Enum-ul serverului nu are valoarea trimisă de client
public enum StareComanda { Noua = 0, Livrata = 1 }
// GET /api/comenzi?stare=2 (clientul: 2 = Anulata)public enum StareComanda { Noua = 0, Livrata = 1, Anulata = 2 }Când valoarea e legitimă, enum-ul serverului trebuie actualizat.
2Clientul trimite poziția din listă, nu valoarea
// dropdown: [Livrata, Noua] -> trimite indexul 1 crezând că e Noua// trimite numele valorii: ?stare=NouaNumele valorilor sunt mai stabile decât numerele; folosește-le în API-uri.
Repară eroarea, direct în pagină
Aplicația de livrări a început să ceară comenzile anulate cu ?stare=2, iar GET /api/comenzi?stare=2 răspunde 400 (The value '2' is invalid.). Adaugă în enum valoarea Anulata = 2, ca filtrarea să întoarcă comanda anulată.
using System.ComponentModel.DataAnnotations;
using Microsoft.AspNetCore.Mvc;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllers();
var app = builder.Build();
app.MapControllers();
app.Run();
// TODO: lipsește starea Anulata = 2
public enum StareComanda { Noua = 0, Livrata = 1 }
public record Comanda(int Id, string Client, StareComanda Stare);
[ApiController]
[Route("api/comenzi")]
public class ComenziController : ControllerBase
{
private static readonly List<Comanda> comenzi =
[
new(1, "Ana", StareComanda.Livrata),
new(2, "Ion", StareComanda.Noua),
new(3, "Maria", (StareComanda)2)
];
[HttpGet]
public IActionResult Filtreaza(StareComanda stare) => Ok(comenzi.Where(c => c.Stare == stare).Select(c => c.Client));
}GET /api/comenzi?stare=2 → 200 OK ["Maria"] GET /api/comenzi?stare=Livrata → 200 OK ["Ana"]
Indiciu
Controllerele acceptă numere de enum doar dacă valoarea e definită.
Reparația
using System.ComponentModel.DataAnnotations;
using Microsoft.AspNetCore.Mvc;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllers();
var app = builder.Build();
app.MapControllers();
app.Run();
public enum StareComanda { Noua = 0, Livrata = 1, Anulata = 2 }
public record Comanda(int Id, string Client, StareComanda Stare);
[ApiController]
[Route("api/comenzi")]
public class ComenziController : ControllerBase
{
private static readonly List<Comanda> comenzi =
[
new(1, "Ana", StareComanda.Livrata),
new(2, "Ion", StareComanda.Noua),
new(3, "Maria", StareComanda.Anulata)
];
[HttpGet]
public IActionResult Filtreaza(StareComanda stare) => Ok(comenzi.Where(c => c.Stare == stare).Select(c => c.Client));
}De ce merge
Binding-ul a citit numărul 2, dar enum-ul serverului nu avea nicio valoare cu acest număr, deci l-a respins. Cu Anulata = 2 definit, conversia reușește, iar acțiunea filtrează comenzile. Valorile explicite (= 0, = 1, = 2) țin numerele stabile și când reordonezi membrii.
Alte forme ale mesajului
The value '7' is invalid."errors":{"stare":["The value '2' is invalid."]}
Cum o eviți pe viitor
- În API-uri publice, expune enum-urile ca text (nume), nu ca numere.
- Când adaugi o valoare într-un enum, actualizează serverul înaintea clienților.
- Dă valori explicite fiecărui membru (
Noua = 0), ca reordonarea să nu schimbe numerele. - Adaugă
JsonStringEnumConverterpentru corpurile JSON, ca enum-urile să circule ca text și acolo.
Întrebări frecvente
De ce Minimal APIs acceptă ?stare=99?
Minimal APIs folosesc Enum.TryParse, care acceptă orice număr, chiar dacă nu e definit. Controllerele MVC verifică dacă valoarea există. Pentru Minimal APIs, adaugă tu verificarea cu Enum.IsDefined.
Numele valorii e sensibil la majuscule?
În controllere nu: ?stare=livrata funcționează. În Minimal APIs da: acolo trebuie scris exact.
Erori înrudite
The value 'laptop-gaming' is not valid for id. Model binding-ul nu a putut converti textul din rută, query sau formular în tipul parametrului: ai cerut int, dar ai primit 'laptop-gaming'. Pune o constrângere de rută ({id:int}) ca valorile greșite să nu ajungă la acțiune, sau trimite valoarea în formatul corect. {"type":"https://tools.ietf.org/html/rfc9110#section-15.5.1","title":"One or more validation errors occurred.","status":400,"errors":{"Cantitate":["The field Cantitate must be between 1 and 100."]}} Un controller cu [ApiController] a validat automat datele primite și a găsit erori, așa că a răspuns 400 cu ValidationProblemDetails înainte să ruleze acțiunea. Proprietatea errors spune, pentru fiecare câmp, ce regulă a picat. Corectează datele trimise sau regula greșită din model. Î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.
