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

The field Cod must be a string with a maximum length of 5.

Pe scurt

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

Greșit
C#
[StringLength(5)] public string Cod { get; set; } = "";
// POST {"cod": "PROMO2026"}
Corect
C#
// POST {"cod": "VARA5"}

Valoarea trebuie să respecte limita stabilită pentru câmp.

2Mesaj tehnic arătat utilizatorului

Greșit
C#
[StringLength(5, MinimumLength = 3)]
public string Cod { get; set; } = "";
Corect
C#
[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ă tu

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}).

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 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}%");
}
După reparație, programul afișează
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}...")].

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 ErrorMessage pentru 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

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