Tag: dotnet-11

Um mergulho profundo no pipeline de transformadores OpenAPI embutido no .NET 11: transformadores de operação versus de esquema, os objetos de contexto, a ordem de execução, transformadores ativados por DI e receitas para cabeçalhos, respostas, exemplos e ajustes por propriedade.

Entidades owned carregam uma chave oculta e identidade de referência que conflitam com value objects. Veja como mapear um value object como tipo complexo no EF Core 11, quando trocar e as armadilhas.

Conforme as versoes preliminares do .NET 11 avancam para o lancamento de novembro, o Runtime Async se formou: projetos net11.0 sao ativados com uma unica propriedade do MSBuild, e as proprias bibliotecas do runtime agora sao compiladas com ele.

PGO (otimização guiada por perfil) permite que o JIT do .NET especialize o código quente para os tipos e ramos que sua carga de trabalho realmente executa. O Dynamic PGO está ligado por padrão desde o .NET 8, então no .NET 8 e versões posteriores você não precisa ativar. Aqui está o que ele faz, como ver o efeito e os casos raros em que você mexe no ajuste.

A compilação em camadas permite que o JIT do .NET compile cada método duas vezes: primeiro rápido e sem otimização para colocar sua aplicação em execução, e depois de novo com otimizações completas quando o runtime sabe que um método é quente. Aqui você verá como o tier 0, o tier 1, a substituição na pilha e o Dynamic PGO se encaixam, e como observá-los e ajustá-los.

dotnet build compila seu projeto para o ciclo de desenvolvimento interno e usa Debug por padrão. dotnet publish executa o target Publish do MSBuild, usa Release por padrão em net8.0 e versões posteriores, e empacota uma pasta pronta para implantação com os assets web, os runtimes autocontidos, o arquivo único, o trimming e o AOT já resolvidos. Aqui está exatamente o que cada um produz e quando usá-lo.

dotnet run compila seu projeto uma vez e o inicia. dotnet watch envolve o dotnet run em um observador de arquivos: ele reinicia ou aplica hot reload na app toda vez que você salva um arquivo fonte. Aqui está exatamente o que cada um faz, o que o dotnet watch define que o dotnet run não define, e quando usar cada um.

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.

Código trim-safe é código que o trimmer do .NET consegue provar estaticamente que é alcançável, então ele sobrevive quando o código não usado é removido de um app self-contained. Este é o guia prático: ligue o analisador, leve cada aviso IL2xxx a zero, anote a reflexão com DynamicallyAccessedMembers, propague RequiresUnreferencedCode para APIs públicas e substitua padrões não analisáveis por geradores de código-fonte.

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.