The field Cantitate must be between 1 and 5.
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
[Range(1, 5)] public int Cantitate { get; set; }
// regula nouă: maxim 50 de bucăți pe comandă[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ă
// POST {"produs": "Mouse", "cantitate": 0}// POST {"produs": "Mouse", "cantitate": 1}Când regula e corectă, 400 e răspunsul potrivit: clientul trebuie să-și corecteze datele.
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.
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}");
}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].
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 class ArticolCos
{
public string Produs { get; set; } = "";
[Range(1, 50)] 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}");
}De ce merge
Validarea făcea exact ce scria în cod; regula era cea depășită. Cu [Range(1, 50)], cantitatea 10 e validă și acțiunea rulează, iar 0 rămâne în afara intervalului și primește 400. Mesajul de eroare se actualizează singur, pentru că e generat din limitele atributului.
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
ErrorMessagecu{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
{"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. The field Cod must be a string with a maximum length of 5. Textul primit e mai lung decât permite [StringLength(max)] (sau [MaxLength]) pe proprietate, iar validarea a răspuns 400. Trimite un text mai scurt, corectează limita dacă e greșită și, pentru utilizatori, dă un mesaj în română cu ErrorMessage. The Descriere field is required. Validarea a găsit o proprietate obligatorie fără valoare. Cu nullable reference types activate, orice string non-nullable (string Descriere) e tratat de controllere ca [Required]. Dacă proprietatea e opțională, declar-o string?; dacă e obligatorie, clientul trebuie să o trimită. Î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.
