...
Eroare ASP.NET Core · Controllere, validare și ProblemDetails

The value '2' is invalid.

Pe scurt

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

Greșit
C#
public enum StareComanda { Noua = 0, Livrata = 1 }
// GET /api/comenzi?stare=2   (clientul: 2 = Anulata)
Corect
C#
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

Greșit
C#
// dropdown: [Livrata, Noua] -> trimite indexul 1 crezând că e Noua
Corect
C#
// trimite numele valorii: ?stare=Noua

Numele valorilor sunt mai stabile decât numerele; folosește-le în API-uri.

Repară tu

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

Codul care dă eroarea
C#
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));
}
După reparație, programul afișează
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ă.

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ă JsonStringEnumConverter pentru 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

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