Etiqueta: aspnetcore

Swashbuckle ya no está en las plantillas de ASP.NET Core. Así se genera y se sirve un documento OpenAPI en .NET 11 con el paquete integrado Microsoft.AspNetCore.OpenApi: AddOpenApi, MapOpenApi, transformadores, varios documentos, generación en tiempo de compilación y una interfaz encima.

Una guía completa para estructurar minimal APIs en ASP.NET Core 11 con MapGroup: módulos de endpoints por recurso como métodos de extensión, grupos anidados, filtros y autenticación compartidos, prefijos con parámetros de ruta, etiquetas OpenAPI y las reglas de orden de filtros que sorprenden.

Conecta HybridCache a un L2 de Redis en ASP.NET Core 11: registra el servicio, agrega la caché distribuida de StackExchange Redis y deja que GetOrCreateAsync te dé una caché de dos niveles con protección contra estampidas y invalidación por etiquetas integradas.

ASP.NET Core 11 trae validación integrada para minimal APIs: llama a AddValidation, anota tu record de solicitud con DataAnnotations y un generador de código fuente valida el modelo enlazado y devuelve 400 ProblemDetails antes de que se ejecute tu handler. Sin controladores, sin FluentValidation, sin comprobaciones manuales.

Una lista de pasos para mover una app de Blazor Server independiente a la plantilla unificada Blazor Web App en .NET 11, manteniendo cada página en InteractiveServer sin cambios de comportamiento.

Elige BackgroundService para bucles en proceso, IHostedService puro cuando necesitas control fino del ciclo de vida, y Hangfire cuando las tareas deben sobrevivir a un reinicio. Una matriz de decisión con código y el detalle que decide por ti.

Llamar a Task.Run desde un controlador pierde trabajo al apagar, se traga las excepciones y captura servicios scoped ya desechados. El patrón seguro es una cola Channel acotada que drena un BackgroundService, que abre un scope nuevo por cada elemento de trabajo y termina el trabajo en curso en StopAsync.

Un BackgroundService es un singleton, así que no puede inyectar directamente un servicio scoped como un DbContext. Toma IServiceScopeFactory, abre un scope por unidad de trabajo con CreateAsyncScope, resuelve dentro de él y deséchalo al terminar.

Para cualquier app Blazor nueva en .NET 11, crea un Blazor Web App (la plantilla antes apodada Blazor United) y elige el modo de render por página. Las plantillas Server-only o WebAssembly-only solo siguen teniendo sentido en casos puntuales.

.NET 11 Preview 4 hace que la generacion de OpenAPI en ASP.NET Core reconozca HTTP QUERY como una operacion de primera clase en OpenAPI 3.2, con un respaldo elegante para documentos 3.0 y 3.1.