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

The field Cantitate must be between 1 and 5.

Pe scurt

Valoarea primită e în afara intervalului definit cu [Range(min, max)] pe proprietate, iar validarea automată a răspuns 400. Dacă datele sunt greșite, clientul trimite o valoare în interval; dacă regula e greșită, corectează limitele atributului.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

[Range(1, 5)] cere ca valoarea să fie între 1 și 5, inclusiv capetele. Când validarea controllerului găsește o valoare în afara intervalului, adaugă mesajul The field Cantitate must be between 1 and 5. la proprietatea respectivă, iar [ApiController] răspunde 400.

Întrebarea importantă e cine greșește: clientul (a trimis 0 sau -3) sau regula (business-ul permite 50 de bucăți, dar cineva a scris 5). Regulile de validare sunt cod, deci și ele pot avea bug-uri, mai ales după schimbări de cerințe.

Pentru decimal, folosește forma [Range(typeof(decimal), "0.01", "10000")], ca limitele să nu treacă prin double. Mesajul îl poți schimba cu ErrorMessage = "Cantitatea trebuie să fie între {1} și {2}".

De ce apare: cauzele frecvente

1Limita din atribut nu mai corespunde regulii de business

Greșit
C#
[Range(1, 5)] public int Cantitate { get; set; }
// regula nouă: maxim 50 de bucăți pe comandă
Corect
C#
[Range(1, 50)] public int Cantitate { get; set; }

Atributul trebuie actualizat când se schimbă regula; altfel respinge comenzi valide.

2Clientul trimite o valoare invalidă

Greșit
C#
// POST {"produs": "Mouse", "cantitate": 0}
Corect
C#
// POST {"produs": "Mouse", "cantitate": 1}

Când regula e corectă, 400 e răspunsul potrivit: clientul trebuie să-și corecteze datele.

Repară tu

Repară eroarea, direct în pagină

Magazinul permite acum comenzi de până la 50 de bucăți, dar POST /api/cos respinge cantitatea 10 cu The field Cantitate must be between 1 and 5.. Actualizează regula din model, ca 10 să fie acceptat, iar 0 să fie respins în continuare.

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();

public class ArticolCos
{
    public string Produs { get; set; } = "";
    // TODO: regula nouă permite maxim 50 de bucăți
    [Range(1, 5)] public int Cantitate { get; set; }
}

[ApiController]
[Route("api/cos")]
public class CosController : ControllerBase
{
    [HttpPost]
    public IActionResult Adauga(ArticolCos articol) => Ok($"Adăugat: {articol.Cantitate} x {articol.Produs}");
}
După reparație, programul afișează
POST /api/cos → 200 OK
Adăugat: 10 x Mouse
POST /api/cos → 400 Bad Request
{"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 50."]}}
Indiciu

Schimbă doar limita superioară a atributului [Range].

Alte forme ale mesajului

  • The field Pret must be between 0.01 and 10000.
  • The field Varsta must be between 18 and 120.

Cum o eviți pe viitor

  • Ține limitele în constante cu nume (Comanda.MaxBucati) și folosește-le în atribut.
  • Scrie teste pentru valorile de la margine (0, 1, max, max + 1).
  • Pentru mesaje în română, folosește ErrorMessage cu {0}, {1}, {2} (numele, minimul, maximul).

Întrebări frecvente

Capetele intervalului sunt incluse?

Da, implicit. Din .NET 8 poți exclude capetele cu MinimumIsExclusive = true sau MaximumIsExclusive = true.

De ce validarea nu pică pentru o proprietate lipsă?

Pentru un int lipsă din JSON, valoarea rămâne 0. Dacă 0 nu e în interval, primești eroarea de interval. Dacă vrei „obligatoriu”, folosește int? cu [Required].

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.