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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
[StringLength(5)] limitează numărul de caractere al unui string. Dacă valoarea are mai mult de 5, validarea controllerului adaugă The field Cod must be a string with a maximum length of 5.. Cu MinimumLength setat, mesajul devine The field Cod must be a string with a minimum length of 3 and a maximum length of 5..
Limitele de lungime au de obicei un motiv concret: coloana din baza de date (nvarchar(5)), un format extern (cod poștal, cod de produs), afișarea. E bine ca limita din DTO să fie aceeași cu cea din baza de date, ca eroarea să apară ca 400 clar, nu ca excepție la salvare.
Mesajele implicite sunt în engleză și conțin numele proprietății din C#. Dacă le arăți utilizatorilor, folosește ErrorMessage, unde {0} e numele câmpului, {1} maximul și {2} minimul.
De ce apare: cauzele frecvente
1Text prea lung
[StringLength(5)] public string Cod { get; set; } = "";
// POST {"cod": "PROMO2026"}// POST {"cod": "VARA5"}Valoarea trebuie să respecte limita stabilită pentru câmp.
2Mesaj tehnic arătat utilizatorului
[StringLength(5, MinimumLength = 3)]
public string Cod { get; set; } = "";[StringLength(5, MinimumLength = 3, ErrorMessage = "Codul trebuie să aibă între {2} și {1} caractere.")]
public string Cod { get; set; } = "";ErrorMessage înlocuiește textul implicit; {1} și {2} sunt maximul și minimul.
Repară eroarea, direct în pagină
Codurile promoționale au 3–5 caractere, iar POST /api/promotii cu PROMO2026 răspunde 400 cu mesajul englezesc The field Cod must be a string with a maximum length of 5.. Păstrează limita, adaugă minimul 3 și mesajul Codul trebuie să aibă între 3 și 5 caractere. (folosind {2} și {1}).
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 PromotieNoua
{
// TODO: minim 3 caractere și mesaj în română
[StringLength(5)] public string Cod { get; set; } = "";
[Range(1, 90)] public int Reducere { get; set; }
}
[ApiController]
[Route("api/promotii")]
public class PromotiiController : ControllerBase
{
[HttpPost]
public IActionResult Creeaza(PromotieNoua p) => Ok($"Cod {p.Cod}: -{p.Reducere}%");
}POST /api/promotii → 400 Bad Request
{"type":"https://tools.ietf.org/html/rfc9110#section-15.5.1","title":"One or more validation errors occurred.","status":400,"errors":{"Cod":["Codul trebuie să aibă între 3 și 5 caractere."]}}
POST /api/promotii → 200 OK
Cod VARA5: -15%Indiciu
[StringLength(5, MinimumLength = 3, ErrorMessage = "...{2}...{1}...")].
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 PromotieNoua
{
[StringLength(5, MinimumLength = 3, ErrorMessage = "Codul trebuie să aibă între {2} și {1} caractere.")]
public string Cod { get; set; } = "";
[Range(1, 90)] public int Reducere { get; set; }
}
[ApiController]
[Route("api/promotii")]
public class PromotiiController : ControllerBase
{
[HttpPost]
public IActionResult Creeaza(PromotieNoua p) => Ok($"Cod {p.Cod}: -{p.Reducere}%");
}De ce merge
Regula de lungime era corectă, dar mesajul era tehnic. ErrorMessage primește un șablon în care {1} este maximul și {2} minimul, deci textul rămâne corect dacă limitele se schimbă. Cererea cu cod prea lung primește în continuare 400, acum cu mesaj în română, iar cea cu VARA5 trece.
Alte forme ale mesajului
The field Cod must be a string with a minimum length of 3 and a maximum length of 5.The field Nume must be a string or array type with a maximum length of '50'.
Cum o eviți pe viitor
- Aliniază limitele din DTO cu cele din baza de date (
HasMaxLength). - Afișează limita în interfață (contor de caractere), ca utilizatorul să nu ajungă la eroare.
- Folosește
ErrorMessagepentru mesajele văzute de utilizatori. - Aplică aceeași limită și în validarea din interfață, ca utilizatorul să afle înainte de trimitere.
Întrebări frecvente
Care e diferența între StringLength și MaxLength?
[StringLength] e doar pentru string-uri și poate avea și minim. [MaxLength] merge și pentru tablouri și liste, iar EF Core îl folosește și pentru dimensiunea coloanei. Mesajele lor diferă.
Spațiile contează la lungime?
Da, sunt caractere. Dacă vrei să le ignori, fă Trim() în client sau într-un convertor înainte de validare.
Erori înrudite
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. The field Produse must be a string or array type with a minimum length of '1'. Atributul [MinLength(n)] a găsit un text sau o listă cu mai puține elemente decât minimul, de exemplu o comandă cu lista de produse goală. Trimite cel puțin n elemente sau verifică dacă atributul e pus pe proprietatea potrivită. {"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.
