Start Debugging

Tag: minimal-apis

13 posts · Página1de2

2026-08-20 errors dotnet dotnet-11

Correção: [FromForm] Dictionary<string, string> é sempre null em uma minimal API

Um Dictionary com [FromForm] em uma minimal API faz binding com prefixo vazio: as chaves do formulário precisam ser [key], não metadata[key]. Envolva em uma classe para manter nomes legíveis.

2026-08-16 csharp dotnet dotnet-11

Como baixar um arquivo a partir de um componente Blazor sem interop com JavaScript

Dispense o módulo JS downloadFileFromStream. Renderize uma âncora com o atributo download apontando para um endpoint de minimal API que devolve TypedResults.File, ou envie por POST um formulário HTML simples com um AntiforgeryToken. Cobre por que o atributo download é o que impede a navegação aprimorada do Blazor de engolir o clique, por que data-enhance descarta o arquivo silenciosamente e a armadilha de cookie versus bearer.

2026-07-23 comparison csharp dotnet

Typed results (Results<>) vs IResult vs IActionResult no ASP.NET Core 11

No ASP.NET Core 11, retorne Results<T1, TN> com TypedResults para minimal APIs e ActionResult<T> para controllers. Trate IResult puro e IActionResult puro como saídas de emergência: eles compilam para qualquer resposta, mas não descrevem nada ao OpenAPI, então você paga por isso em atributos ProducesResponseType escritos à mão.

2026-07-20 aspnetcore dotnet-11 validation

A validação assíncrona chega às Minimal APIs com o .NET 11 Preview 6

O Preview 6 adiciona AsyncValidationAttribute e IAsyncValidatableObject para que as regras de DataAnnotations consultem o banco de dados antes de o seu endpoint rodar, sem bloquear uma thread.

2026-07-14 csharp dotnet dotnet-11

Como retornar uma união tipada Results<T1, T2> de um endpoint de minimal API no ASP.NET Core 11

Declare o tipo de retorno do handler como Results<Ok<T>, NotFound> e retorne TypedResults.Ok / TypedResults.NotFound: a união oferece verificação em tempo de compilação de que o handler só retorna o que declara, e ela se autodescreve ao OpenAPI para que você nunca escreva .Produces na mão. Cobre handlers assíncronos, o limite de seis tipos e testes no ASP.NET Core 11.

2026-07-09 migration aspnetcore dotnet-11

Migrar uma minimal API de verificações de validação manuais para a validação integrada no ASP.NET Core 11

Guia passo a passo para substituir verificações manuais (if) nos handlers de uma minimal API do ASP.NET Core 11 pelo validador integrado baseado em DataAnnotations e geração de código-fonte: o que quebra, quais regras manuais dá para portar e quais não, e como verificar que o contrato 400 ProblemDetails continua idêntico.

2026-07-06 errors dotnet dotnet-11

Correção: "415 Unsupported Media Type" de um endpoint de minimal API no ASP.NET Core 11

Uma minimal API retorna 415 quando o Content-Type da requisição não corresponde ao que o endpoint faz o binding. Envie Content-Type: application/json para um tipo vinculado ao corpo, ou use [FromForm] para formulários e uploads de arquivos.

2026-07-03 csharp dotnet dotnet-11

Como personalizar respostas de erro de validação de minimal APIs com IProblemDetailsService no ASP.NET Core 11

Chame AddProblemDetails com um callback CustomizeProblemDetails para remodelar o 400 que a validação embutida de minimal APIs retorna no ASP.NET Core 11: adicione um traceId, reescreva o title, troque 400 por 422, ou assuma o controle total com um IProblemDetailsWriter personalizado.

2026-06-15 comparison aspnetcore dotnet-11

Validação de minimal API vs FluentValidation no ASP.NET Core 11: qual você deve escolher?

Use a validação integrada gerada por código-fonte para regras síncronas expressáveis por atributos no ASP.NET Core 11; recorra ao FluentValidation quando precisar de regras assíncronas, lógica complexa entre campos ou manter a validação fora dos seus modelos de domínio.

2026-06-07 csharp dotnet dotnet-11

Como organizar endpoints de minimal API com MapGroup no ASP.NET Core 11

Um guia completo para estruturar minimal APIs no ASP.NET Core 11 com MapGroup: módulos de endpoints por recurso como métodos de extensão, grupos aninhados, filtros e autenticação compartilhados, prefixos com parâmetros de rota, tags OpenAPI e as regras de ordem de filtros que surpreendem.