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ă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
[MinLength] și [MaxLength] funcționează și pentru string-uri, și pentru colecții (tablouri, liste), de aceea mesajul spune „string or array type”. [MinLength(1)] pe o listă înseamnă „cel puțin un element”: o comandă fără produse, un formular fără opțiuni.
O capcană: [Required] pe o listă nu respinge lista goală, ci doar null. Pentru „nu poate fi goală” ai nevoie de [MinLength(1)] (sau de [Length(1, 20)] din .NET 8).
Cealaltă capcană e un copy-paste greșit: [MinLength(8)] ajuns de la Parola pe Nume face ca numele scurte să fie respinse. Mesajul îți spune proprietatea și minimul: verifică dacă sunt cele pe care le aștepți.
De ce apare: cauzele frecvente
1Comandă trimisă fără produse
public class ComandaNoua
{
[MinLength(1)] public List<string> Produse { get; set; } = [];
}
// POST {"produse": []}// POST {"produse": ["Mouse"]}Lista goală e respinsă intenționat: o comandă trebuie să aibă cel puțin un produs.
2Atribut copiat pe proprietatea greșită
[MinLength(8)] public string Nume { get; set; } = "";
public string Parola { get; set; } = "";public string Nume { get; set; } = "";
[MinLength(8)] public string Parola { get; set; } = "";Regula de lungime minimă era pentru parolă; pe nume respinge valori corecte.
Repară eroarea, direct în pagină
La înregistrare, numele Ion e respins cu The field Nume must be a string or array type with a minimum length of '8'., iar parola 123 e acceptată. Atributul [MinLength(8)] a ajuns pe proprietatea greșită: mută-l pe Parola, ca prima cerere să fie acceptată, iar a doua (parolă scurtă) respinsă.
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 Inregistrare
{
// TODO: regula de lungime minimă e pe proprietatea greșită
[MinLength(8)] public string Nume { get; set; } = "";
public string Parola { get; set; } = "";
}
[ApiController]
[Route("api/conturi")]
public class ConturiController : ControllerBase
{
[HttpPost]
public IActionResult Creeaza(Inregistrare date) => Ok($"Cont creat pentru {date.Nume}");
}POST /api/conturi → 200 OK
Cont creat pentru Ion
POST /api/conturi → 400 Bad Request
{"type":"https://tools.ietf.org/html/rfc9110#section-15.5.1","title":"One or more validation errors occurred.","status":400,"errors":{"Parola":["The field Parola must be a string or array type with a minimum length of '8'."]}}Indiciu
Regula de 8 caractere ține de parolă, nu de nume.
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 Inregistrare
{
public string Nume { get; set; } = "";
[MinLength(8)] public string Parola { get; set; } = "";
}
[ApiController]
[Route("api/conturi")]
public class ConturiController : ControllerBase
{
[HttpPost]
public IActionResult Creeaza(Inregistrare date) => Ok($"Cont creat pentru {date.Nume}");
}De ce merge
Validarea aplica minimul de 8 caractere numelui, din cauza unui copy-paste. Mutat pe Parola, atributul respinge parolele scurte și lasă numele scurte să treacă. Mesajul din a doua cerere arată acum proprietatea corectă, Parola. Regula rămâne în model, unde o poate vedea oricine citește DTO-ul.
Alte forme ale mesajului
The field Parola must be a string or array type with a minimum length of '8'.The field Nume must be a string or collection type with a minimum length of '1' and maximum length of '50'.
Cum o eviți pe viitor
- Pentru liste care nu pot fi goale, folosește
[MinLength(1)], nu[Required]. - Revizuiește atributele când copiezi proprietăți între clase.
- Scrie un test pentru lista goală și unul pentru lungimea minimă exactă.
- Pentru mesaje în română, folosește
ErrorMessage, cu{0}pentru numele câmpului și{1}pentru lungimea minimă.
Întrebări frecvente
De ce [Required] nu prinde lista goală?
[Required] verifică doar că valoarea nu e null (și, la string-uri, că nu e goală). O listă goală nu e null, deci trece.
Ce e [Length] din .NET 8?
[Length(min, max)] combină minimul și maximul pentru string-uri și colecții într-un singur atribut.
Erori înrudite
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ă. {"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.
