{"id":1322,"date":"2026-03-28T09:00:38","date_gmt":"2026-03-28T12:00:38","guid":{"rendered":"https:\/\/maurobernal.com.ar\/blog\/validacion-de-datos-en-net-10-con-data-annotations-guia-completa\/"},"modified":"2026-03-28T09:00:38","modified_gmt":"2026-03-28T12:00:38","slug":"validacion-de-datos-en-net-10-con-data-annotations-guia-completa","status":"publish","type":"post","link":"https:\/\/maurobernal.com.ar\/blog\/validacion-de-datos-en-net-10-con-data-annotations-guia-completa\/","title":{"rendered":"Validacion de Datos en .NET 10 con Data Annotations: Guia Completa"},"content":{"rendered":"

Validar los datos de entrada es una de las primeras l\u00edneas de defensa de cualquier API. En .NET, la forma m\u00e1s directa de hacerlo es con Data Annotations<\/strong>: atributos que se aplican sobre las propiedades del modelo y que ASP.NET Core eval\u00faa autom\u00e1ticamente antes de que el request llegue a tu l\u00f3gica de negocio.<\/p>\n

En esta primera parte repasamos en profundidad c\u00f3mo funciona Data Annotations en .NET 10, sus capacidades y sus l\u00edmites. En la segunda parte<\/a> comparamos esta estrategia contra FluentValidation<\/strong>.<\/p>\n

\u00bfQu\u00e9 son los Data Annotations?<\/h2>\n

Los Data Annotations son atributos del namespace System.ComponentModel.DataAnnotations<\/code> que se aplican directamente sobre las propiedades de un modelo para declarar reglas de validaci\u00f3n. ASP.NET Core los eval\u00faa durante el model binding<\/em> y popula autom\u00e1ticamente ModelState<\/code> con los errores encontrados.<\/p>\n

using System.ComponentModel.DataAnnotations;\n\npublic class CreateUserRequest\n{\n    [Required(ErrorMessage = \"El email es obligatorio.\")]\n    [EmailAddress(ErrorMessage = \"El formato del email no es v\u00e1lido.\")]\n    [MaxLength(150)]\n    public string Email { get; set; } = string.Empty;\n\n    [Required(ErrorMessage = \"El nombre es obligatorio.\")]\n    [StringLength(80, MinimumLength = 2, ErrorMessage = \"El nombre debe tener entre 2 y 80 caracteres.\")]\n    public string Name { get; set; } = string.Empty;\n\n    [Range(13, 120, ErrorMessage = \"La edad debe estar entre 13 y 120.\")]\n    public int Age { get; set; }\n}<\/code><\/pre>\n
Con este modelo, ASP.NET Core valida autom\u00e1ticamente cada request antes de ejecutar el action method.<\/p>\n
Integraci\u00f3n autom\u00e1tica en ASP.NET Core (Controllers)<\/h2>\n
En una aplicaci\u00f3n MVC o Web API con controllers, la validaci\u00f3n es completamente autom\u00e1tica. Solo ten\u00e9s que verificar ModelState.IsValid<\/code>:<\/p>\n
[ApiController]\n[Route(\"api\/[controller]\")]\npublic class UsersController : ControllerBase\n{\n    [HttpPost]\n    public async Task<IActionResult> Create([FromBody] CreateUserRequest request)\n    {\n        \/\/ Si los atributos fallan, ASP.NET Core devuelve 400 autom\u00e1ticamente\n        \/\/ (gracias al atributo [ApiController])\n\n        \/\/ ... l\u00f3gica de negocio\n        return Created($\"\/api\/users\/{Guid.NewGuid()}\", request);\n    }\n}<\/code><\/pre>\n
El atributo [ApiController]<\/code> activa la validaci\u00f3n autom\u00e1tica del ModelState<\/code>: si alguna regla falla, el framework devuelve un 400 Bad Request<\/code> con el detalle de los errores sin que tengas que escribir c\u00f3digo adicional.<\/p>\n
Integraci\u00f3n en Minimal APIs (.NET 10)<\/h2>\n
En Minimal APIs, la validaci\u00f3n no es autom\u00e1tica. En .NET 10 se puede activar de forma expl\u00edcita con el nuevo filtro integrado:<\/p>\n
var builder = WebApplication.CreateBuilder(args);\nvar app = builder.Build();\n\napp.MapPost(\"\/users\", async (CreateUserRequest request) =>\n{\n    \/\/ La validaci\u00f3n de anotaciones se puede activar con un endpoint filter\n    return Results.Created($\"\/users\/{Guid.NewGuid()}\", request);\n})\n.AddEndpointFilter<ValidationFilter<CreateUserRequest>>();<\/code><\/pre>\n
O implementando un filtro gen\u00e9rico reutilizable:<\/p>\n
public class ValidationFilter<T> : IEndpointFilter\n{\n    public async ValueTask<object?> InvokeAsync(EndpointFilterInvocationContext ctx, EndpointFilterDelegate next)\n    {\n        var model = ctx.Arguments.OfType<T>().FirstOrDefault();\n        if (model is null) return Results.BadRequest(\"Payload requerido.\");\n\n        var context = new ValidationContext(model);\n        var results = new List<ValidationResult>();\n\n        if (!Validator.TryValidateObject(model, context, results, validateAllProperties: true))\n        {\n            var errors = results\n                .GroupBy(r => r.MemberNames.FirstOrDefault() ?? \"General\")\n                .ToDictionary(\n                    g => g.Key,\n                    g => g.Select(r => r.ErrorMessage!).ToArray()\n                );\n\n            return Results.ValidationProblem(errors);\n        }\n\n        return await next(ctx);\n    }\n}<\/code><\/pre>\n
Atributos m\u00e1s usados<\/h2>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Atributo<\/th>\nDescripci\u00f3n<\/th>\n<\/tr>\n<\/thead>\n
[Required]<\/code><\/td>\nEl campo no puede ser null ni vac\u00edo<\/td>\n<\/tr>\n
[StringLength(max, MinimumLength = min)]<\/code><\/td>\nLongitud de string entre m\u00edn y m\u00e1x<\/td>\n<\/tr>\n
[MaxLength(n)]<\/code> \/ [MinLength(n)]<\/code><\/td>\nLongitud m\u00e1xima o m\u00ednima<\/td>\n<\/tr>\n
[Range(min, max)]<\/code><\/td>\nValor num\u00e9rico dentro de un rango<\/td>\n<\/tr>\n
[EmailAddress]<\/code><\/td>\nFormato de email v\u00e1lido<\/td>\n<\/tr>\n
[Url]<\/code><\/td>\nFormato de URL v\u00e1lida<\/td>\n<\/tr>\n
[Phone]<\/code><\/td>\nFormato de n\u00famero telef\u00f3nico<\/td>\n<\/tr>\n
[RegularExpression(pattern)]<\/code><\/td>\nValidaci\u00f3n con expresi\u00f3n regular<\/td>\n<\/tr>\n
[Compare(\"OtherProp\")]<\/code><\/td>\nCompara el valor con otra propiedad<\/td>\n<\/tr>\n
[CreditCard]<\/code><\/td>\nN\u00famero de tarjeta de cr\u00e9dito v\u00e1lido<\/td>\n<\/tr>\n
[AllowedValues(...)]<\/code><\/td>\nValor dentro de un conjunto permitido (.NET 8+)<\/td>\n<\/tr>\n
[DeniedValues(...)]<\/code><\/td>\nValor fuera de un conjunto denegado (.NET 8+)<\/td>\n<\/tr>\n
[Length(min, max)]<\/code><\/td>\nLongitud de colecciones o strings (.NET 8+)<\/td>\n<\/tr>\n
[Base64String]<\/code><\/td>\nString Base64 v\u00e1lido (.NET 8+)<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
Validaciones personalizadas<\/h2>\n
Opci\u00f3n 1: IValidatableObject<\/h3>\n
Para l\u00f3gica que involucra m\u00faltiples propiedades del mismo modelo:<\/p>\n
public class CreateUserRequest : IValidatableObject\n{\n    public string? Email { get; set; }\n    public int Age { get; set; }\n\n    public IEnumerable<ValidationResult> Validate(ValidationContext validationContext)\n    {\n        if (Age < 18 && Email?.EndsWith(\".work\") == true)\n            yield return new ValidationResult(\n                \"Los menores no pueden registrarse con un email de trabajo.\",\n                new[] { nameof(Email) }\n            );\n    }\n}<\/code><\/pre>\n
Opci\u00f3n 2: Atributo personalizado<\/h3>\n
Para reglas reutilizables en m\u00faltiples modelos:<\/p>\n
public class NoDisposableEmailAttribute : ValidationAttribute\n{\n    private static readonly string[] _blocked = { \"test@test.com\", \"lorem@ipsum.com\" };\n\n    protected override ValidationResult? IsValid(object? value, ValidationContext context)\n    {\n        if (value is string email && _blocked.Contains(email.ToLower()))\n            return new ValidationResult(\"Us\u00e1 un email real, no uno descartable.\");\n\n        return ValidationResult.Success;\n    }\n}\n\n\/\/ Uso\n[NoDisposableEmail]\npublic string Email { get; set; } = string.Empty;<\/code><\/pre>\n
Respuesta de error: ProblemDetails<\/h2>\n
Con [ApiController]<\/code>, los errores de validaci\u00f3n se devuelven autom\u00e1ticamente como ValidationProblemDetails<\/code> (RFC 7807):<\/p>\n
{\n  \"type\": \"https:\/\/tools.ietf.org\/html\/rfc9110#section-15.5.1\",\n  \"title\": \"One or more validation errors occurred.\",\n  \"status\": 400,\n  \"errors\": {\n    \"Email\": [\"El formato del email no es v\u00e1lido.\"],\n    \"Name\": [\"El nombre es obligatorio.\"]\n  }\n}<\/code><\/pre>\n
Limitaciones de Data Annotations<\/h2>\n