The field CodPostal must match the regular expression '^\d{5}$'.
Valoarea nu se potrivește cu expresia regulată din [RegularExpression]. Mesajul îți arată chiar regex-ul: verifică dacă datele sunt greșite sau dacă regula nu descrie formatul real (de exemplu codurile poștale din România au 6 cifre, nu 5).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
[RegularExpression("^\d{5}$")] acceptă doar valorile care se potrivesc în întregime cu expresia (atributul o tratează ca și cum ar avea ^...$, chiar dacă nu le scrii). Mesajul implicit include expresia, ceea ce te ajută la depanare, dar nu e potrivit pentru utilizatori.
Când o valoare care pare corectă e respinsă, de obicei regex-ul e prea strict: format din altă țară (cod poștal de 5 cifre în loc de 6), spații sau liniuțe nepermise, litere mici neacceptate. Testează expresia pe câteva valori reale înainte s-o pui în model.
Ca la celelalte atribute de format, null e acceptat (câmp lipsă); pentru obligatoriu combină cu [Required]. Mesajul se schimbă cu ErrorMessage.
De ce apare: cauzele frecvente
1Regex scris pentru alt format
[RegularExpression(@"^\d{5}$")] public string CodPostal { get; set; } = "";
// România: 6 cifre, de exemplu 010011[RegularExpression(@"^\d{6}$", ErrorMessage = "Codul poștal are 6 cifre.")]
public string CodPostal { get; set; } = "";Expresia trebuie să descrie formatul real al datelor, iar mesajul să fie înțeles de utilizator.
2Spații sau litere mici neacceptate
[RegularExpression("^[A-Z]{2}[0-9]{2}[A-Z]{3}$")] public string Numar { get; set; } = "";
// trimis: "b 12 abc"// normalizează în client: "B12ABC" (fără spații, majuscule)Fie normalizezi datele înainte de trimitere, fie extinzi expresia să accepte variantele.
Repară eroarea, direct în pagină
Adresele de livrare din România sunt respinse cu The field CodPostal must match the regular expression '^\d{5}$'., pentru că expresia cere 5 cifre. Schimbă regula la 6 cifre, cu mesajul Codul poștal are 6 cifre., ca 010011 să fie acceptat, iar 1234 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 AdresaLivrare
{
public string Oras { get; set; } = "";
// TODO: codurile poștale din România au 6 cifre
[RegularExpression(@"^\d{5}$")] public string CodPostal { get; set; } = "";
}
[ApiController]
[Route("api/adrese")]
public class AdreseController : ControllerBase
{
[HttpPost]
public IActionResult Salveaza(AdresaLivrare a) => Ok($"Livrare în {a.Oras}, cod {a.CodPostal}");
}POST /api/adrese → 200 OK
Livrare în București, cod 010011
POST /api/adrese → 400 Bad Request
{"type":"https://tools.ietf.org/html/rfc9110#section-15.5.1","title":"One or more validation errors occurred.","status":400,"errors":{"CodPostal":["Codul poștal are 6 cifre."]}}Indiciu
[RegularExpression(@"^\d{6}$", ErrorMessage = "...")].
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 AdresaLivrare
{
public string Oras { get; set; } = "";
[RegularExpression(@"^\d{6}$", ErrorMessage = "Codul poștal are 6 cifre.")]
public string CodPostal { get; set; } = "";
}
[ApiController]
[Route("api/adrese")]
public class AdreseController : ControllerBase
{
[HttpPost]
public IActionResult Salveaza(AdresaLivrare a) => Ok($"Livrare în {a.Oras}, cod {a.CodPostal}");
}De ce merge
Codurile poștale românești au 6 cifre, deci expresia ^\d{5}$ respingea toate adresele corecte. Cu ^\d{6}$, 010011 se potrivește, iar 1234 nu. ErrorMessage înlocuiește mesajul tehnic, care afișa regex-ul, cu unul pe care utilizatorul îl înțelege. Regula rămâne în model, aproape de datele pe care le descrie.
Alte forme ale mesajului
The field Cod must match the regular expression '^[A-Z]{3}$'.
Cum o eviți pe viitor
- Testează expresia pe valori reale (inclusiv margini) înainte să o folosești.
- Folosește
ErrorMessagecu o explicație pe înțeles, nu regex-ul. - Normalizează datele (spații, majuscule) înainte de validare, când e posibil.
- Pentru formate complexe, preferă un atribut propriu cu cod clar.
Întrebări frecvente
Trebuie să scriu ^ și $?
Nu e obligatoriu: atributul verifică oricum potrivirea întregii valori. Le poți scrie pentru claritate.
De ce în mesaj apar două backslash-uri?
În JSON, backslash-ul e escapat, deci \d apare ca \\d. Expresia reală are un singur backslash.
Erori înrudite
The Telefon field is not a valid e-mail address. Atributul [EmailAddress] a respins valoarea pentru că nu arată ca o adresă de email (lipsește @ sau ce e în jurul lui). Dacă proprietatea chiar e email, clientul trebuie să trimită o adresă validă; dacă mesajul apare pe alt câmp (aici Telefon), atributul e pus greșit. 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. {"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.
